Account

List projects

The projects this key can read. Every other endpoint takes one of these ids.

GEThttps://api.vidrys.com/v1/projects

Plan: Grow and above
Key: read
Rate cost: 1 unit
MCP tool: list_projects

List projects

curl --request GET \
  --url "https://api.vidrys.com/v1/projects" \
  --header "Authorization: Bearer $VIDRYS_API_KEY"

200 · success

{
  "projects": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "Acme Invoicing",
      "industry": "Accounting software"
    },
    {
      "id": "7f1b6a2d-91c4-4e05-9a3b-2d4e6f8a1c90",
      "name": "Acme Payroll",
      "industry": "HR software"
    }
  ]
}

Authorization

Sent as a header on every request.

Authorizationstringrequired

A Vidrys API key, sent as Bearer vidrys_sk_…. A read key is enough. See Authentication.

Response · 200

application/json

projectsobject[]

Projects in the workspace.

+Show child attributes

idstring

Project id (a UUID). Every project-scoped call takes it.

namestring

The brand the project tracks.

industrystringnullable

The industry set on the project.

Errors

401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on Grow, Scale and Custom.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.