Skip to main content

​
Document IDs

When you create a document in Logic, it is assigned a unique identifier known as the document ID. This ID is used to reference the document in API requests and is essential for executing, updating, or deleting the document. You can find the document ID in the Logic dashboard, or you can retrieve it using the Logic API. The document ID is a UUID (Universally Unique Identifier) that looks like this: a901abfe-398d-447d-a0cc-c071b40339f3. You can also use the document slug, which is a human-readable version of the document ID that might look like this: analyze-invoice-po-notes.

​
Retrieving the Document slug via the dashboard

document-id You can find the document slug in the Logic dashboard by selection the document you want to work with. The document slug is displayed in the URL of the document editor, and it is also shown in the document’s integration tab.

​
Retrieving a List of Available Documents with the API

To retrieve a list of the documents available on your dashboard, you can use the /v1/documents endpoint. This will return a JSON object containing the ID of your document, created and updated dates, the slug you can use to refer to it for API requests, and more. 
curl 'https://api.logic.inc/v1/documents/'
 -H "Authorization: Bearer $LOGIC_API_TOKEN"

​
Example Document List

{
    {
      "id": "a901abfe-398d-447d-a0cc-c071b40339f3",
      "createdBy": "c04fdb6c-10e3-4abc-81ef-acd4c1b22ecb",
      "createdAt": "2025-04-28T09:19:09.508Z",
      "updatedAt": "2025-04-28T09:19:13.863Z",
      "orgId": "00000000-0000-4000-a000-000000000001",
      "currentVersionId": "da384a64-339e-422f-8a40-ccdb1cdcbe5e",
      "description": null,
      "draftVersionId": null,
      "draftVersionStatus": null,
      "slug": "analyze-invoice-po-notes",
      "title": "Processing Invoices"
    },
    {
      "id": "9fe247d4-bc32-4ad1-ae2b-ad36428e72ae",
      "createdBy": "da384a64-339e-422f-8a40-ccdb1cdcbe5e",
      "createdAt": "2024-10-17T06:28:46.832Z",
      "updatedAt": "2025-04-28T08:49:20.067Z",
      "orgId": "00000000-0000-4000-a000-000000000001",
      "currentVersionId": "f262e499-41e3-42e3-a987-07b7c955eecc",
      "description": "This guide standardizes the creation of Git commit messages for projects, ensuring each message clearly and concisely represents the staged changes while following a strict house style.",
      "draftVersionId": "8eac5a51-4026-4a1d-bd50-9caf25bedefb",
      "draftVersionStatus": "DRAFT",
      "slug": "generate-commit-message-from-diff-and-branch",
      "title": "Git Commit Message Guide"
    }
}

​
Retrieving a Specific Document

You can also retrieve info for a specific document by adding the ID or slug to the end of the /v1/documents/ endpoint. 
curl 'https://api.logic.inc/v1/documents/{document_id}/'
-H "Authorization: Bearer $LOGIC_API_TOKEN"
Replace any {id} in the example code, such as {document_id} with the ID you need for your specific API call.
⌘I