List accessible Knowledge libraries

GET/v1/knowledge

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters

None.

Query parameters

None.

Body schema

This endpoint does not require a request body.

None.

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Organization-scoped Knowledge library listapplication/json

Field	Type	Required	Description
object	list	Yes	—
data	object[]	Yes	—
data[].id	string	Yes	Unique identifier.
data[].name	string	Yes	Human-readable name.
data[].description	string	Yes	Human-readable description.
data[].homeDocumentId	string	Yes	—
data[].creatorId	string	No	—
data[].creatorUserId	string	No	—
data[].creatorName	string	No	—
data[].creatorEmail	string	No	—
data[].creatorAvatarUrl	string	No	—
data[].ownerId	string	No	—
data[].ownerUserId	string	No	—
data[].ownerName	string	No	—
data[].ownerEmail	string	No	—
data[].ownerAvatarUrl	string	No	—
data[].currentVersionId	string	Yes	—
data[].currentVersionNumber	integer	Yes	—
data[].publishedVersionId	string	No	—
data[].cover	object	Yes	—
data[].cover.schemaVersion	computer_agents_knowledge_cover_v1	Yes	—
data[].cover.type	gradient	Yes	—
data[].cover.preset	blue	Yes	—
data[].metadata	object	No	Free-form metadata object.
data[].permissionSet	object	No	—
data[].documents	object[]	No	—
data[].documents[].id	string	Yes	Unique identifier.
data[].documents[].libraryId	string	Yes	—
data[].documents[].revisionId	string	Yes	—
data[].documents[].currentRevisionId	string	No	—
data[].documents[].parentDocumentId	string	No	—
data[].documents[].slug	string	No	—
data[].documents[].sortOrder	integer	No	—
data[].documents[].archived	boolean	No	—
data[].documents[].title	string	Yes	Display title.
data[].documents[].name	string	No	Human-readable name.
data[].documents[].summary	string	No	—
data[].documents[].description	string	No	Human-readable description.
data[].documents[].markdown	string	Yes	—
data[].documents[].content	string	No	Raw text content.
data[].documents[].contentHash	string	Yes	—
data[].documents[].provenance	object	No	—
data[].documents[].createdByUserId	string	No	—
data[].documents[].revisionCreatedByUserId	string	No	—
data[].documents[].createdAt	string	Yes	ISO 8601 timestamp.
data[].documents[].revisionCreatedAt	string	No	—
data[].documents[].updatedAt	string	Yes	ISO 8601 timestamp.
data[].versions	object[]	No	—
data[].versions[].id	string	Yes	Unique identifier.
data[].versions[].number	integer	No	—
data[].versions[].versionNumber	integer	Yes	—
data[].versions[].name	string	No	Human-readable name.
data[].versions[].description	string	No	Human-readable description.
data[].versions[].status	saved \| published	Yes	Current lifecycle status.
data[].versions[].fingerprint	string	Yes	—
data[].versions[].publishedAt	string	No	—
data[].versions[].createdAt	string	Yes	ISO 8601 timestamp.
data[].versions[].updatedAt	string	Yes	ISO 8601 timestamp.
data[].createdAt	string	Yes	ISO 8601 timestamp.
data[].updatedAt	string	Yes	ISO 8601 timestamp.

List accessible Knowledge libraries

Response 200

See the ACP quickstart and SDK flow