API Resources

Upload

Upload a file to Tackd.io.

POST /upload

Query Parameters

AttributeTypeRequirementNotes
expiresint/stringoptionalSet data expiration time in seconds, or s, m, h, d, w, y
readsintoptionalSet maximum number of reads for data
pwdstringoptionalLock data with additional password
filenamestringoptionalSpecify filename for upload
tagsstringoptionalComma separated tags

Response Codes

TypeCodeNotes
Success200Returns json object
Error500Internal server error

Sample Response

{
  "message": "Saved",
  "url": "https://tackd.io/download/d2e1152b-ef91-4e4a-834c-62c41a4278e9?key=ldR9aQY5pBZThQtgsvb0YqK9xmerCBN0",
  "data": {
    "id": "d2e1152b-ef91-4e4a-834c-62c41a4278e9",
    "key": "ldR9aQY5pBZThQtgsvb0YqK9xmerCBN0",
    "expires in": 3600,
    "max reads": 1
  }
}

Download

Download a file from Tackd.io.

GET /download/{id}

Path Parameters

AttributeTypeRequirementNotes
idstringrequiredSpecify data id or file to download

Query Parameters

AttributeTypeRequirementNotes
idstringoptionalID to get, use if filename is passed in path
keystringrequiredDecryption key
pwdstringoptionalUnlock data with password

Response Codes

TypeCodeNotes
Success200Returns binary data
Error404Not Found
Error500Internal server error

List Uploads

List user's uploads.

GET /api/v1/uploads

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Query Parameters

AttributeTypeRequirementNotes
tagsstringoptionalFilter by tags, comma seperated

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

[
  {
    "id": "436bdf7f-6d6e-4d26-8177-364ee5c61dca",
    "meta": {
      "created": "2022-12-06T02:07:57.168752Z",
      "content_type": "application/x-www-form-urlencoded",
      "user_agent": "curl/7.84.0",
      "bytes": 44
    },
    "lifecycle": {
      "max": {
        "reads": -1,
        "seconds": 3600,
        "expires": 1670296077
      },
      "current": {
        "reads": 7
      }
    },
    "links": [
      {
        "id": "95345270-5dfe-4d98-aae0-db6ffc73e21d",
        "created": "2022-12-06T02:07:57.168750Z",
        "reads": 2
      },
      {
        "id": "d44b0655-b8db-4706-ad8b-8186e18f8604",
        "created": "2022-12-06T02:08:30.307616Z",
        "reads": 5
      }
    ]
  }
]

Get Upload

Get single user upload info.

GET /api/v1/uploads/{id}

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Path Parameters

AttributeTypeRequirementNotes
idstringrequiredSpecify upload id

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

[
  {
    "id": "436bdf7f-6d6e-4d26-8177-364ee5c61dca",
    "meta": {
      "created": "2022-12-06T02:07:57.168752Z",
      "content_type": "application/x-www-form-urlencoded",
      "user_agent": "curl/7.84.0",
      "bytes": 44
    },
    "lifecycle": {
      "max": {
        "reads": -1,
        "seconds": 3600,
        "expires": 1670296077
      },
      "current": {
        "reads": 2
      }
    },
    "links": [
      {
        "id": "95345270-5dfe-4d98-aae0-db6ffc73e21d",
        "created": "2022-12-06T02:07:57.168750Z",
        "reads": 2
      }
    ]
  }
]

Delete Upload

Delete single user upload.

DELETE /api/v1/uploads/{id}

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Path Parameters

AttributeTypeRequirementNotes
idstringrequiredSpecify upload id

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

{
  "deleted": true
}

List Upload Links

List upload links.

GET /api/v1/uploads/{id}/links

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Path Parameters

AttributeTypeRequirementNotes
idstringrequiredSpecify upload id

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

[
  {
    "id": "9aa8de6b-8b4f-492c-b8b7-cd6356387a3f",
    "created": "2022-12-03T03:06:35.260646162Z"
  }
]

Create Upload Link

Create new upload link.

PUT /api/v1/uploads/{id}/links

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Path Parameters

AttributeTypeRequirementNotes
idstringrequiredSpecify upload id

Query Parameters

AttributeTypeRequirementNotes
tagsstringoptionalComma separated tags

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

{
  "created": true,
  "url": "https://tackd.io/download/a1ef26eb-ae9e-4793-855b-ebb00aba048f?key=D1i03EFoDvT15HZNtOCdb03rnBqo5TvQ",
  "data": {
    "id": "a1ef26eb-ae9e-4793-855b-ebb00aba048f",
    "key": "D1i03EFoDvT15HZNtOCdb03rnBqo5TvQ",
    "created": "2022-12-03T15:06:51.003586994Z"
  }
}

Delete Upload Link

Create new upload link.

DELETE /api/v1/uploads/{id}/links/{link}

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Path Parameters

AttributeTypeRequirementNotes
idstringrequiredSpecify upload id
linkstringrequiredSpecify link id

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

{
  "deleted": true
}

Get Upload Tags

Get tags for uploaded data.

GET /api/v1/uploads/{id}/tags

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Path Parameters

AttributeTypeRequirementNotes
idstringrequiredSpecify upload id

Query Parameters

AttributeTypeRequirementNotes
tagsstringoptionalComma separated tags

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

[
  "type:pptx",
  "modified:true"
]

Add Upload Tags

Create new tag or tags for uploaded data.

PUT /api/v1/uploads/{id}/tags

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Path Parameters

AttributeTypeRequirementNotes
idstringrequiredSpecify upload id

Query Parameters

AttributeTypeRequirementNotes
tagsstringoptionalComma separated tags

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

[
  "newtag:value"
]

Register New User

Register a new email with Tackd.io.

POST /api/v1/user

Payload Parameters (JSON)

FieldTypeNotes
emailStringUser's email
pwdStringUser's password

Response Codes

TypeCodeNotes
Success200Success
Error409Email already exists
Error500Internal server error

Sample Payload

{
  "email": "myemail@gmail.com",
  "pwd": "mypassword"
}

Sample Response

{
  "created": true,
  "user id": "37a8a05b-742d-4306-bdd8-9e7c4236d42b"
}

Recover User ID

Recover UUID for email from Tackd.io.

POST /api/v1/user/recover/id

Payload Parameters (JSON)

FieldTypeNotes
emailStringUser's email
pwdStringUser's password

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Payload

{
  "email": "myemail@gmail.com",
  "pwd": "mypassword"
}

Sample Response

{
  "email": "myemail@gmail.com",
  "user id": "4424e943-64c8-4098-921c-93443815d32e"
}

Create API Key

Create API key for user.

POST /api/v1/user/apiKeys

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Query Parameters

AttributeTypeRequirementNotes
tagsstringoptionalComma separated tags
rolestringoptionaladmin or upload, defaults to upload

Response Codes

TypeCodeNotes
Success200Success
Error401Not Found
Error500Internal server error

Sample Response

{
  "created": true,
  "data": {
    "key": "CzsIzBHz",
    "secret": "00d757a55081cc58896c",
    "created": "2022-11-28T00:33:24.366572901Z",
    "access": {
      "role": "upload"
    }
  }
}

List API Keys

List API keys for user.

GET /api/v1/user/apiKeys

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

[
  {
    "key": "CzsIzBHz",
    "created": "2022-11-28T00:33:24.366572901Z",
    "access": {
      "role": "admin"
    }
  }
]

Delete API Key

Delete user's API key.

DELETE /api/v1/user/apiKeys/{key}

Authentication

TypeUserNotes
BasicUUIDUnique User ID
BasicAPI KeyAPI Key/Secret

Path Parameters

AttributeTypeRequirementNotes
keystringrequiredSpecify API key

Response Codes

TypeCodeNotes
Success200Success
Error401Unauthorized
Error500Internal server error

Sample Response

{
  "delete": true
}