COcomposiohq
Projects
Organization Management

Get project details by ID With Org Api key

Changed on

Retrieves detailed information about a specific project using its unique identifier. This endpoint provides complete project configuration including webhook URLs, creation and update timestamps, and webhook secrets. Use this endpoint to inspect project settings or verify project configuration.

get/api/v3/org/owner/project/{nano_id}

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3/org/owner/project/{nano_id}
  • Auth
    API key in header x-org-api-key

Path parameters

nano_idstring projectId required

Unique identifier (Nano ID) of the project to retrieve

Example:pr_1a2b3c4d5e6f

Response

Project retrieved successfully. Returns a complete project object with all configuration details and associated API keys.

idstring projectId required

Unique identifier for the project

org_idstring orgId required

Identifier of the organization that owns this project

namestring required

Name of the project

emailstring required

Email address associated with the project

created_atstring required

ISO timestamp when the project was created

updated_atstring required

ISO timestamp when the project was last updated

webhook_urlstring uri nullable required

DEPRECATED: Use GET /api/v3/webhook_subscriptions instead. Legacy project-level webhook URL.

event_webhook_urlstring uri nullable required

DEPRECATED: No longer used.

webhook_secretstring nullable required

DEPRECATED: Use GET /api/v3/webhook_subscriptions instead. Legacy project-level webhook secret.

triggers_enabledboolean

Whether triggers are enabled for this project

last_subscribed_atstring date-time nullable

ISO timestamp when the project last subscribed to updates

is_new_webhookboolean

Deprecated: Please refer to webhook_version instead. True indicates if the webhook configuration is using the previous new format (V2). False indicates the oldest format (V1)

webhook_version'V1' | 'V2' | 'V3' required

Payload format version for Pusher real-time events only. For webhook configuration, use GET /api/v3/webhook_subscriptions.

deletedboolean required

Whether this project has been deleted

Example response

{
  "id": "pr_1a2b3c4d5e6f",
  "org_id": "ok_1a2b3c4d5e6f",
  "name": "My Awesome Project",
  "email": "project-123@composio.dev",
  "created_at": "2023-05-16T14:30:00.000Z",
  "updated_at": "2023-05-18T09:15:30.000Z",
  "webhook_url": "https://example.com/webhook",
  "event_webhook_url": "https://example.com/events",
  "webhook_secret": "whsec_abcdef123456789",
  "triggers_enabled": true,
  "last_subscribed_at": "2023-05-17T10:00:00.000Z",
  "is_new_webhook": true,
  "webhook_version": "V2",
  "api_keys": [
    {
      "id": "01H4DKRF5SMP7NQCA3BWT0JYB6",
      "name": "Production Server Key",
      "key": "ak_**6j0z",
      "created_at": "2023-07-15T14:30:00.000Z"
    }
  ]
}

Changes

  • 881fa7b9eb11Revision changes
    • info

      added the non-success response with the status

    • info

      response property event_webhook_url deprecated

    • info

      response property is_new_webhook deprecated

    • info

      response property webhook_secret deprecated

    • info

      response property webhook_url deprecated

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property to the response with the status