Create document - SquadVault

POST

/

documents

Create document

curl --request POST \
  --url https://api.squadvault.xyz/v1/documents \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "organizationId": "org_example",
  "name": "Playbook Q3",
  "fileUrl": "s3://your-bucket/documents/org_example/example.pdf",
  "fileKey": "documents/org_example/example.pdf",
  "contentType": "application/pdf",
  "sizeBytes": 102400
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    organizationId: 'org_example',
    name: 'Playbook Q3',
    fileUrl: 's3://your-bucket/documents/org_example/example.pdf',
    fileKey: 'documents/org_example/example.pdf',
    contentType: 'application/pdf',
    sizeBytes: 102400
  })
};

fetch('https://api.squadvault.xyz/v1/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.squadvault.xyz/v1/documents"

payload = {
    "organizationId": "org_example",
    "name": "Playbook Q3",
    "fileUrl": "s3://your-bucket/documents/org_example/example.pdf",
    "fileKey": "documents/org_example/example.pdf",
    "contentType": "application/pdf",
    "sizeBytes": 102400
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "<string>",
  "organizationId": "<string>",
  "teamId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "fileUrl": "<string>",
  "fileKey": "<string>",
  "contentType": "<string>",
  "sizeBytes": 123,
  "uploadedBy": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "tags": [
    "playbook"
  ],
  "team": {
    "id": "<string>",
    "name": "<string>"
  },
  "uploadedByUser": {
    "id": "<string>",
    "name": "<string>"
  }
}

Authorizations

x-api-key

string

header

required

Organization API key from Settings → API keys.

Body

application/json

organizationId

string

required

name

string

required

fileUrl

string<uri>

required

fileKey

string

required

Must start with documents/{organizationId}/

contentType

enum<string>

required

Available options:

application/pdf,

application/msword,

application/vnd.openxmlformats-officedocument.wordprocessingml.document,

application/vnd.ms-excel,

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,

text/plain,

image/jpeg,

image/png,

image/webp,

image/gif

sizeBytes

integer

required

Required range: 1 <= x <= 26214400

description

string | null

tags

enum<string>[]

Available options:

playbook,

contract,

management,

content,

legal,

other

teamId

string | null

Response

Created document

id

string

organizationId

string

teamId

string | null

name

string

description

string | null

fileUrl

string

fileKey

string

contentType

string

sizeBytes

integer

uploadedBy

string | null

createdAt

string<date-time>

updatedAt

string<date-time>

tags

enum<string>[]

Available options:

playbook,

contract,

management,

content,

legal,

other

team

object | null

Show child attributes

uploadedByUser

object | null

Show child attributes

Create document

curl --request POST \
  --url https://api.squadvault.xyz/v1/documents \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "organizationId": "org_example",
  "name": "Playbook Q3",
  "fileUrl": "s3://your-bucket/documents/org_example/example.pdf",
  "fileKey": "documents/org_example/example.pdf",
  "contentType": "application/pdf",
  "sizeBytes": 102400
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    organizationId: 'org_example',
    name: 'Playbook Q3',
    fileUrl: 's3://your-bucket/documents/org_example/example.pdf',
    fileKey: 'documents/org_example/example.pdf',
    contentType: 'application/pdf',
    sizeBytes: 102400
  })
};

fetch('https://api.squadvault.xyz/v1/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.squadvault.xyz/v1/documents"

payload = {
    "organizationId": "org_example",
    "name": "Playbook Q3",
    "fileUrl": "s3://your-bucket/documents/org_example/example.pdf",
    "fileKey": "documents/org_example/example.pdf",
    "contentType": "application/pdf",
    "sizeBytes": 102400
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "<string>",
  "organizationId": "<string>",
  "teamId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "fileUrl": "<string>",
  "fileKey": "<string>",
  "contentType": "<string>",
  "sizeBytes": 123,
  "uploadedBy": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "tags": [
    "playbook"
  ],
  "team": {
    "id": "<string>",
    "name": "<string>"
  },
  "uploadedByUser": {
    "id": "<string>",
    "name": "<string>"
  }
}