Integration

Search and filter integration

post

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

nextTokenstringOptionalExample: eyJza2lwIjoxMH0

pageSizeinteger · min: 1 · max: 100OptionalDefault: 10

Responses

200

Success

application/json

nextTokenstringOptional

totalCountintegerOptionalExample: 12

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/integration/search

HTTPcURLJavaScriptPython

POST /v1/integration/search HTTP/1.1
Host: api.draftt.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "filter": {
    "type": "aws"
  },
  "sort": {
    "createdAt": "asc"
  },
  "nextToken": "eyJza2lwIjoxMH0",
  "pageSize": 10
}

{
  "items": [
    {
      "id": 1,
      "name": "My AWS Integration",
      "type": "aws",
      "status": "Healthy",
      "details": {
        "externalId": "abc123",
        "roleArn": "arn:aws:iam::123456789012:role/my-role",
        "accountId": "123456789012"
      },
      "createdAt": "2024-12-01T12:00:00.000Z",
      "updatedAt": "2024-12-23T12:00:00.000Z"
    }
  ],
  "nextToken": "text",
  "totalCount": 12
}

Retrieve a specific integration by ID

get

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

integrationIdintegerRequired

Responses

200

Success

application/json

nextTokenstring · enumOptionalPossible values:

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

get

/integration/{integrationId}

HTTPcURLJavaScriptPython

GET /v1/integration/{integrationId} HTTP/1.1
Host: api.draftt.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": 1,
      "name": "My AWS Integration",
      "type": "aws",
      "status": "Healthy",
      "details": {
        "externalId": "abc123",
        "roleArn": "arn:aws:iam::123456789012:role/my-role",
        "accountId": "123456789012"
      },
      "createdAt": "2024-12-01T12:00:00.000Z",
      "updatedAt": "2024-12-23T12:00:00.000Z"
    }
  ],
  "nextToken": null
}