List organization projects

GET

/api/v1/projects

curl --request GET \
  --url 'https://api.yggy.tech/api/v1/projects?limit=20&offset=0&sortBy=createdAt&sortDir=asc' \
  --header 'Authorization: Bearer <token>'

• Production

List projects in the active organization with pagination, search, and sort. Default sort is recentlyViewed (last-viewed desc, falling back to createdAt desc), so a user with no views yet gets creation-time order. name orders by project name. Search is a case-insensitive substring over project name and slug.

Authorizations

• bearerAuth
• apiKeyAuth

Parameters

Query Parameters

limit

Page size, from 1 to 100.

integer

default: 20 >= 1 <= 100

Page size, from 1 to 100.

offset

Zero-based offset for pagination.

integer | null

0

Zero-based offset for pagination.

q

Case-insensitive substring search over project name and slug. Omit or leave blank to list every project.

string

<= 200 characters

Case-insensitive substring search over project name and slug. Omit or leave blank to list every project.

sortBy

RecentlyViewed orders by the caller’s last-viewed timestamp (falls back to createdAt desc when no views exist), createdAt orders by creation time, name orders by project name (case-insensitive).

string

default: recentlyViewed

Allowed values: createdAt recentlyViewed name

RecentlyViewed orders by the caller’s last-viewed timestamp (falls back to createdAt desc when no views exist), createdAt orders by creation time, name orders by project name (case-insensitive).

sortDir

string

default: desc

Allowed values: asc desc

Responses

200

Projects retrieved successfully

Media type application/json

object

success

required

boolean

projects

required

Array<object>

object

id

required

string

slug

required

string

name

required

string

color

required

string

organizationId

required

string

externalId

string | null

kind

string

Allowed values: shared personal

extractionPurpose

string | null

<= 500 characters

extractionInclude

Array<string>

<= 25 items

extractionSkip

Array<string>

<= 25 items

extractionGuidanceRevision

integer

entityMergeMode

string

Allowed values: auto always_review

createdAt

string

updatedAt

string

documentCount

required

integer

tripleCount

required

integer

entityCount

required

integer

pinned

required

Array<object>

object

id

required

string

slug

required

string

name

required

string

color

required

string

organizationId

required

string

externalId

string | null

kind

string

Allowed values: shared personal

extractionPurpose

string | null

<= 500 characters

extractionInclude

Array<string>

<= 25 items

extractionSkip

Array<string>

<= 25 items

extractionGuidanceRevision

integer

entityMergeMode

string

Allowed values: auto always_review

createdAt

string

updatedAt

string

documentCount

required

integer

tripleCount

required

integer

entityCount

required

integer

personal

required

object

id

required

string

slug

required

string

name

required

string

color

required

string

organizationId

required

string

externalId

string | null

kind

string

Allowed values: shared personal

extractionPurpose

string | null

<= 500 characters

extractionInclude

Array<string>

<= 25 items

extractionSkip

Array<string>

<= 25 items

extractionGuidanceRevision

integer

entityMergeMode

string

Allowed values: auto always_review

createdAt

string

updatedAt

string

documentCount

required

integer

tripleCount

required

integer

entityCount

required

integer

total

required

integer

limit

required

integer

> 0

offset

required

integer

Example

{
  "projects": [
    {
      "kind": "shared",
      "entityMergeMode": "auto"
    }
  ],
  "pinned": [
    {
      "kind": "shared",
      "entityMergeMode": "auto"
    }
  ],
  "personal": {
    "kind": "shared",
    "entityMergeMode": "auto"
  }
}

400

Bad request - no active organization

Media type application/json

object

success

required

boolean

error

required

object

message

required

string

code

required

string

Allowed values: INTERNAL_ERROR VALIDATION_ERROR UNAUTHORIZED RATE_LIMITED ORG_REQUIRED FORBIDDEN NOT_FOUND CONFLICT PROJECT_DENIED USAGE_LIMIT_EXCEEDED HUGINN_ERROR HUGINN_STREAM_ERROR QUERY_FAILED PROVIDER_CONFLICT PROVIDER_CONFIG_INVALID PROVIDER_NOT_CONNECTED PROVIDER_RATE_LIMITED PROJECT_MEMBER_USER_NOT_IN_ORG PROJECT_MEMBER_UNKNOWN_ROLE PROJECT_MEMBER_LAST_OWNER PROJECT_CONFLICT STORAGE_NOT_CONFIGURED BILLING_NOT_CONFIGURED LICENSE_INACTIVE PLAN_REQUIRED MEMBER_LIMIT_REACHED SAGA_ASK_QUOTA_EXCEEDED SAGA_ASK_RATE_LIMITED SAGA_ASK_BUSY SAGA_ASK_PAUSED SAGA_ASK_UPSTREAM SAGA_DICTATION_BUSY SAGA_DICTATION_UNAVAILABLE SAGA_SHARE_LINK_LIMIT PROJECT_MEMBERSHIP_JWT_TOO_LARGE WEBHOOK_URL_INVALID WEBHOOK_ADDRESS_BLOCKED WEBHOOK_EVENT_UNKNOWN WEBHOOK_ENDPOINT_LIMIT WEBHOOK_ENDPOINT_DISABLED WEBHOOK_DELIVERY_IN_PROGRESS ORG_KEY_PERSONAL_SCOPE API_KEY_PERMISSION_EXCEEDS_ROLE API_KEY_NO_PERMISSIONS ORG_KEY_GRAPH_SCOPE_UNAVAILABLE ORG_KEY_TOO_MANY_PROJECTS SENDER_IS_LOGIN_EMAIL SENDER_TAKEN

details

Example

{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR"
  }
}

401

Unauthorized - no active session

Media type application/json

object

success

required

boolean

error

required

object

message

required

string

code

required

string

Allowed values: INTERNAL_ERROR VALIDATION_ERROR UNAUTHORIZED RATE_LIMITED ORG_REQUIRED FORBIDDEN NOT_FOUND CONFLICT PROJECT_DENIED USAGE_LIMIT_EXCEEDED HUGINN_ERROR HUGINN_STREAM_ERROR QUERY_FAILED PROVIDER_CONFLICT PROVIDER_CONFIG_INVALID PROVIDER_NOT_CONNECTED PROVIDER_RATE_LIMITED PROJECT_MEMBER_USER_NOT_IN_ORG PROJECT_MEMBER_UNKNOWN_ROLE PROJECT_MEMBER_LAST_OWNER PROJECT_CONFLICT STORAGE_NOT_CONFIGURED BILLING_NOT_CONFIGURED LICENSE_INACTIVE PLAN_REQUIRED MEMBER_LIMIT_REACHED SAGA_ASK_QUOTA_EXCEEDED SAGA_ASK_RATE_LIMITED SAGA_ASK_BUSY SAGA_ASK_PAUSED SAGA_ASK_UPSTREAM SAGA_DICTATION_BUSY SAGA_DICTATION_UNAVAILABLE SAGA_SHARE_LINK_LIMIT PROJECT_MEMBERSHIP_JWT_TOO_LARGE WEBHOOK_URL_INVALID WEBHOOK_ADDRESS_BLOCKED WEBHOOK_EVENT_UNKNOWN WEBHOOK_ENDPOINT_LIMIT WEBHOOK_ENDPOINT_DISABLED WEBHOOK_DELIVERY_IN_PROGRESS ORG_KEY_PERSONAL_SCOPE API_KEY_PERMISSION_EXCEEDS_ROLE API_KEY_NO_PERMISSIONS ORG_KEY_GRAPH_SCOPE_UNAVAILABLE ORG_KEY_TOO_MANY_PROJECTS SENDER_IS_LOGIN_EMAIL SENDER_TAKEN

details

Example

{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR"
  }
}

500

Internal server error

Media type application/json

object

success

required

boolean

error

required

object

message

required

string

code

required

string

Allowed values: INTERNAL_ERROR VALIDATION_ERROR UNAUTHORIZED RATE_LIMITED ORG_REQUIRED FORBIDDEN NOT_FOUND CONFLICT PROJECT_DENIED USAGE_LIMIT_EXCEEDED HUGINN_ERROR HUGINN_STREAM_ERROR QUERY_FAILED PROVIDER_CONFLICT PROVIDER_CONFIG_INVALID PROVIDER_NOT_CONNECTED PROVIDER_RATE_LIMITED PROJECT_MEMBER_USER_NOT_IN_ORG PROJECT_MEMBER_UNKNOWN_ROLE PROJECT_MEMBER_LAST_OWNER PROJECT_CONFLICT STORAGE_NOT_CONFIGURED BILLING_NOT_CONFIGURED LICENSE_INACTIVE PLAN_REQUIRED MEMBER_LIMIT_REACHED SAGA_ASK_QUOTA_EXCEEDED SAGA_ASK_RATE_LIMITED SAGA_ASK_BUSY SAGA_ASK_PAUSED SAGA_ASK_UPSTREAM SAGA_DICTATION_BUSY SAGA_DICTATION_UNAVAILABLE SAGA_SHARE_LINK_LIMIT PROJECT_MEMBERSHIP_JWT_TOO_LARGE WEBHOOK_URL_INVALID WEBHOOK_ADDRESS_BLOCKED WEBHOOK_EVENT_UNKNOWN WEBHOOK_ENDPOINT_LIMIT WEBHOOK_ENDPOINT_DISABLED WEBHOOK_DELIVERY_IN_PROGRESS ORG_KEY_PERSONAL_SCOPE API_KEY_PERMISSION_EXCEEDS_ROLE API_KEY_NO_PERMISSIONS ORG_KEY_GRAPH_SCOPE_UNAVAILABLE ORG_KEY_TOO_MANY_PROJECTS SENDER_IS_LOGIN_EMAIL SENDER_TAKEN

details

Example

{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR"
  }
}