OPTIONAL. Create a new conversation with the Copilot. The conversation ID can be used in the sendMessage endpoint. The sendMessage endpoint automatically creates new conversations upon first request, but calling this endpoint can simplify certain use cases where it is helpful for the application to have the conversation ID before the first message is sent.

Example0

Create Conversation

Provide Message Feedback

Send Message

Copilots

Example1

Upload Document Contents

Bulk patch metadata for documents, synced natively by Credal or manual API uploads

Metadata

Document Catalog

Add documents to a document collection. Note that the documents must already exist in the document catalog to use this endpoint. If you want to upload a new document to a collection, use the uploadDocumentContents endpoint.

addDocumentsToCollectionExample

Add Documents To Collection

Document Collections

Admin endpoint to check whether the specified user is authorized to read the specified resource.

Check Resource Authorization For User

Admin endpoint to check whether the specified user is authorized to read the specified set of resources.

Check Bulk Resources Authorization For User

Admin endpoint to list all resources that the specified user is authorized to read. Note this endpoint returns cached results and may not be up-to-date. You can use the checkResourceAuthorizationForUser endpoint with disableCache set to true to get the most up-to-date results.

List Cached Authorized Resources For User

Permissions Service

Search across all documents in a document collection using the document metadata and contents.

searchDocumentCollectionExample

Search Document Collection

Search

Users

ExternalResourceId

ResourceIdentifier

ResourceType

CreateConversationResponse

FeedbackEnum

InsertedAuditLog

MessageBlocked

MessageFeedback

MessageReply

PolicyTrigger

ReferencedSource

ResponseChunk

SendAgentMessageResponse

SendMessageResponse

Returned when there is a reply
fetched from the copilot.


Returned when Credal detects possible
infosec violations and blocks the message.


DocumentMetadataPatch

The identifier for the resource you want to patch

DocumentMetadataPatchRequest

UploadDocumentResponse

Action

AuthorizedResource

AuthorizedResourceListPage

CheckBulkResourcesAuthorizationResponse

CheckResourceAuthorizationResponse

Group

Principal

PrincipalListPage

ResourceAuthorizationResult

User

DocumentCollectionSearchOptions

The maximum number of chunks to return. Defaults to 10.

Whether to merge the chunks for a document and just return one result per document. Defaults to false.

The similarity threshold between 0 and 1 for the search results. A higher number leads to fewer but more relevant results.
Defaults to 0.45.

Whether to automatically filter the search results based on the user query and available metadata on the collection. Defaults to false.

Whether to rerank the search results after the initial semantic search query. Defaults to false.

DocumentCollectionSearchResult

Operator

SearchDocumentCollectionResponse

SearchResultChunk

The similarity score between 0 and 1 for the search result. A higher number means the chunk is more relevant to the search query.

1	curl -X POST https://api.credal.ai/api/v0/copilots/sendMessage \
2	-H "Authorization: Bearer <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"agentId": "82e4b12a-6990-45d4-8ebd-85c00e030c24",
6	"message": "Is Credal SOC 2 compliant?",
7	"userEmail": "ravin@credal.ai"
8	}'

1	{
2	"sendChatResult": {
3	"type": "ai_response_result",
4	"conversationId": "fc938005-92db-411a-88eb-32ca50d5f744",
5	"inserted_audit_log": {
6	"id": "5842804e-ffbe-4f8d-873e-f007fff93440"
7	},
8	"messageId": "dd721cd8-4bf2-4b94-9869-258df3dab9dc",
9	"policy_triggers": [],
10	"referencedSources": [
11	{
12	"id": "1",
13	"externalResourceId": {
14	"externalResourceId": "123456",
15	"resourceType": "GOOGLE_DRIVE_ITEM"
16	},
17	"name": "Example Document",
18	"url": "https://drive.google.com/file/d/123456/view"
19	}
20	],
21	"response": {
22	"message": "Based on the context provided, Credal is SOC 2 compliant...",
23	"dataChunk": "...SOC 2 is a technical audit that requires companies to establish and follow strict information security policies and procedures. Credal's SOC 2 report is available upon request..."
24	},
25	"sourcesInDataContext": [
26	{
27	"id": "1",
28	"externalResourceId": {
29	"externalResourceId": "123456",
30	"resourceType": "GOOGLE_DRIVE_ITEM"
31	},
32	"name": "Example Document",
33	"url": "https://drive.google.com/file/d/123456/view"
34	},
35	{
36	"id": "2",
37	"externalResourceId": {
38	"externalResourceId": "123457",
39	"resourceType": "GOOGLE_DRIVE_ITEM"
40	},
41	"name": "Example Document 2",
42	"url": "https://drive.google.com/file/d/123457/view"
43	}
44	],
45	"warnings": []
46	}
47	}