Installs

Install a listing

Install a listing by its id. A listed entry, a draft and a listing in review all install; a suspended one answers 409 listing_suspended. Installing again answers the existing install. After the publisher removed this project's access, installing answers 403 install_blocked.

post/v1/projects/{project_id}/installs

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/installs
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Request body

listing_idstring required

Example request

{
  "listing_id": "lst_V1StGXR8Z5jdHi6B"
}

Response

The project had already installed the listing.

idstring required
project_idstring required

The installing project.

listing_idstring required
resource_type'tool' | 'agent' required
resource_idstring required

The id the project names the installed resource by.

state'active' | 'suspended' | 'blocked' required

active while usable, suspended while its listing is, blocked after the publisher removed the project's access.

installed_atstring date-time required
updated_atstring date-time required

Example response

{
  "id": "ins_V1StGXR8Z5jdHi6B",
  "project_id": "proj_6NgFz3xXy2kPq9Wd",
  "listing_id": "lst_V1StGXR8Z5jdHi6B",
  "resource_type": "tool",
  "resource_id": "tool_V1StGXR8Z5jdHi6B",
  "state": "active",
  "installed_at": "2026-10-01T00:00:00.000Z",
  "updated_at": "2026-10-01T00:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.