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

# Resolve the organization consumer project

`POST /api/v3/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.
  - `config` object, required — Consumer project configuration bag (consumer-experience and enhanced-controls flags, plus any provider-specific keys).
    - `consumer_experience_enabled` boolean, required — Whether the consumer experience is enabled for this project.
    - `enhanced_controls` boolean, required — Whether enhanced controls are enabled for this consumer project.
    - `clanker` boolean — Whether org members share a single clanker bot identity for connected accounts.
  - `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.dev/composiohq/apis/composio-platform-api.md) · [All operations](https://skmtc.dev/composiohq/apis/composio-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api/revisions/368fb7851f42/schema)