---
title: "Resolve the organization consumer project"
method: POST
path: "/api/v3.1/org/consumer/project/resolve"
tags: ["Projects", "Organization Management", "x-internal"]
---

# Resolve the organization consumer project

`POST /api/v3.1/org/consumer/project/resolve`

Finds the authenticated organization's single CONSUMER project and provisions it if absent. This endpoint is idempotent and never returns consumer API keys.

## Headers

- `x-user-api-key` string, required — User API key used to authenticate the request.
- `x-org-id` string, orgId, required — Organization nano ID that scopes the user API key resolution.

## Response `200`

Consumer project resolved successfully.

- object
  - `project_id` string, uuid, required — UUID of the resolved consumer project.
  - `project_nano_id` string, projectId, required — Nano ID of the resolved consumer project.
  - `project_name` string, required — Name of the resolved consumer project.
  - `org_id` string, orgId, required — Organization nano ID that owns the consumer project.
  - `project_type` 'CONSUMER', required — Resolved project type.
  - `consumer_user_id` string, required — Derived internal Composio user ID for the authenticated user in this consumer org context.

## Other responses

- `400` — Bad request. x-org-id is required for user API key authentication.
- `401` — Unauthorized. A valid user API key is required.
- `403` — Forbidden.
- `404` — Org not found or deleted.
- `500` — Internal server error.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)