Skip to main content
GET
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
dependencies
Project Dependencies
curl --request GET \
  --url https://api.example.com/v1/organizations/{organizationId}/projects/{projectId}/dependencies \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "version": "<string>"
}
'
Projects can depend on other projects, allowing you to share components and content types across projects. This page covers all dependency management operations.

List Dependencies

GET/v1/organizations//projects//dependencies

Path Parameters

organizationId
string
required
Organization ID
projectId
string
required
Project ID

Response

{
  "data": [
    {
      "projectId": "proj456",
      "name": "UI Components",
      "version": "2.0.0"
    }
  ]
}

Add Dependency

POST/v1/organizations//projects//dependencies

Request Body

projectId
string
required
ID of the project to depend on
version
string
required
Semantic version of the dependency (e.g., “2.0.0”)

Example Request

{
  "projectId": "proj456",
  "version": "2.0.0"
}

Response

Returns the updated Project object with the new dependency added.

Error Responses

Dependency Not Found

{
  "error": {
    "code": "DEPENDENCY_NOT_FOUND",
    "message": "Dependent project not found",
    "details": {
      "projectId": "proj456"
    }
  }
}

Version Not Found

{
  "error": {
    "code": "VERSION_NOT_FOUND",
    "message": "Specified version does not exist",
    "details": {
      "projectId": "proj456",
      "version": "2.0.0"
    }
  }
}

Circular Dependency

{
  "error": {
    "code": "CIRCULAR_DEPENDENCY",
    "message": "Adding this dependency would create a circular reference",
    "details": {
      "path": ["proj123", "proj456", "proj123"]
    }
  }
}

Remove Dependency

DELETE/v1/organizations//projects//dependencies/

Path Parameters

organizationId
string
required
Organization ID
projectId
string
required
Project ID
dependentProjectId
string
required
ID of the dependent project to remove

Response

Returns the updated Project object with the dependency removed.

Code Examples

curl -X GET "https://api.metabind.ai/v1/organizations/org123/projects/proj123/dependencies" \
  -H "Authorization: Bearer YOUR_API_KEY"