Remove a file

DELETE

api

reports

{report_id}

files

{file_id}

Remove a file

curl --request DELETE \
  --url https://kalligator.com/api/reports/{report_id}/files/{file_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://kalligator.com/api/reports/{report_id}/files/{file_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://kalligator.com/api/reports/{report_id}/files/{file_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "<string>",
  "program_id": "<string>",
  "program_name": "<string>",
  "status": "draft",
  "display_status": "<string>",
  "title": "<string>",
  "revision": 123,
  "created_at": "<string>",
  "updated_at": "<string>",
  "submitted_at": "<string>",
  "withdrawn_at": "<string>",
  "asset": "<string>",
  "description": "<string>",
  "cvss_vector": "<string>",
  "attachments": {},
  "submission": {
    "submitted_at": "<string>",
    "attachments": {},
    "content": {
      "title": "<string>",
      "asset": "<string>",
      "description": "<string>",
      "cvss_vector": ""
    },
    "program": {
      "policy_version": 123,
      "name": "<string>",
      "scope": "<string>",
      "exclusions": "<string>",
      "rules": "<string>",
      "eligibility": "<string>",
      "disclosure": "<string>",
      "rewards": {}
    },
    "stripe": {
      "status": "<string>",
      "checked_at": "<string>"
    }
  },
  "decision": {
    "outcome": "accepted",
    "at": "<string>",
    "message": "<string>"
  },
  "payout": {
    "status": "approving",
    "amount_cents": 123,
    "approved_at": "<string>",
    "transferred_at": "<string>",
    "received_at": "<string>",
    "payout_failed_at": "<string>"
  }
}

{
  "detail": "<string>",
  "code": "<string>",
  "current": {
    "id": "<string>",
    "program_id": "<string>",
    "program_name": "<string>",
    "status": "draft",
    "display_status": "<string>",
    "title": "<string>",
    "revision": 123,
    "created_at": "<string>",
    "updated_at": "<string>",
    "submitted_at": "<string>",
    "withdrawn_at": "<string>",
    "asset": "<string>",
    "description": "<string>",
    "cvss_vector": "<string>",
    "attachments": {},
    "submission": {
      "submitted_at": "<string>",
      "attachments": {},
      "content": {
        "title": "<string>",
        "asset": "<string>",
        "description": "<string>",
        "cvss_vector": ""
      },
      "program": {
        "policy_version": 123,
        "name": "<string>",
        "scope": "<string>",
        "exclusions": "<string>",
        "rules": "<string>",
        "eligibility": "<string>",
        "disclosure": "<string>",
        "rewards": {}
      },
      "stripe": {
        "status": "<string>",
        "checked_at": "<string>"
      }
    },
    "decision": {
      "outcome": "accepted",
      "at": "<string>",
      "message": "<string>"
    },
    "payout": {
      "status": "approving",
      "amount_cents": 123,
      "approved_at": "<string>",
      "transferred_at": "<string>",
      "received_at": "<string>",
      "payout_failed_at": "<string>"
    }
  }
}

{
  "detail": "<string>",
  "code": "<string>",
  "current": {
    "id": "<string>",
    "program_id": "<string>",
    "program_name": "<string>",
    "status": "draft",
    "display_status": "<string>",
    "title": "<string>",
    "revision": 123,
    "created_at": "<string>",
    "updated_at": "<string>",
    "submitted_at": "<string>",
    "withdrawn_at": "<string>",
    "asset": "<string>",
    "description": "<string>",
    "cvss_vector": "<string>",
    "attachments": {},
    "submission": {
      "submitted_at": "<string>",
      "attachments": {},
      "content": {
        "title": "<string>",
        "asset": "<string>",
        "description": "<string>",
        "cvss_vector": ""
      },
      "program": {
        "policy_version": 123,
        "name": "<string>",
        "scope": "<string>",
        "exclusions": "<string>",
        "rules": "<string>",
        "eligibility": "<string>",
        "disclosure": "<string>",
        "rewards": {}
      },
      "stripe": {
        "status": "<string>",
        "checked_at": "<string>"
      }
    },
    "decision": {
      "outcome": "accepted",
      "at": "<string>",
      "message": "<string>"
    },
    "payout": {
      "status": "approving",
      "amount_cents": 123,
      "approved_at": "<string>",
      "transferred_at": "<string>",
      "received_at": "<string>",
      "payout_failed_at": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

A Firebase ID token, or a Kalligator API key (kal_…).

Path Parameters

report_id

string<uuid4>

required

The report ID.

file_id

string<uuid4>

required

The file ID.

Query Parameters

revision

integer

required

The current report revision.

Required range: x >= 0

Response

Successful Response

string

required

program_id

string

required

program_name

string

required

status

enum<string>

required

The report status. See the report lifecycle guide.

Available options:

draft,

triaging,

needs_info,

paused,

human_review,

accepted,

rejected,

duplicate,

insufficient_info,

withdrawn

display_status

string

required

The status text that the website shows.

title

string

required

revision

integer

required

Increases when you save the draft, upload or remove a file, submit, or withdraw. Send the latest value with your next change.

created_at

string | null

required

updated_at

string | null

required

submitted_at

string | null

required

withdrawn_at

string | null

required

asset

string

required

description

string

required

cvss_vector

string

required

attachments

Attachments · object

required

Files on the report, by file ID.

Show child attributes

submission

Submission · object | null

required

The frozen copy of the report, files, and program policy at submission. null for a draft.

Show child attributes

decision

Decision · object | null

required

The final decision and an optional message. null until a decision.

Show child attributes

payout

Payout · object | null

Your reward payment. null until the Kalligator team approves the reward.

Show child attributes

Remove a file

curl --request DELETE \
  --url https://kalligator.com/api/reports/{report_id}/files/{file_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://kalligator.com/api/reports/{report_id}/files/{file_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://kalligator.com/api/reports/{report_id}/files/{file_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "<string>",
  "program_id": "<string>",
  "program_name": "<string>",
  "status": "draft",
  "display_status": "<string>",
  "title": "<string>",
  "revision": 123,
  "created_at": "<string>",
  "updated_at": "<string>",
  "submitted_at": "<string>",
  "withdrawn_at": "<string>",
  "asset": "<string>",
  "description": "<string>",
  "cvss_vector": "<string>",
  "attachments": {},
  "submission": {
    "submitted_at": "<string>",
    "attachments": {},
    "content": {
      "title": "<string>",
      "asset": "<string>",
      "description": "<string>",
      "cvss_vector": ""
    },
    "program": {
      "policy_version": 123,
      "name": "<string>",
      "scope": "<string>",
      "exclusions": "<string>",
      "rules": "<string>",
      "eligibility": "<string>",
      "disclosure": "<string>",
      "rewards": {}
    },
    "stripe": {
      "status": "<string>",
      "checked_at": "<string>"
    }
  },
  "decision": {
    "outcome": "accepted",
    "at": "<string>",
    "message": "<string>"
  },
  "payout": {
    "status": "approving",
    "amount_cents": 123,
    "approved_at": "<string>",
    "transferred_at": "<string>",
    "received_at": "<string>",
    "payout_failed_at": "<string>"
  }
}

{
  "detail": "<string>",
  "code": "<string>",
  "current": {
    "id": "<string>",
    "program_id": "<string>",
    "program_name": "<string>",
    "status": "draft",
    "display_status": "<string>",
    "title": "<string>",
    "revision": 123,
    "created_at": "<string>",
    "updated_at": "<string>",
    "submitted_at": "<string>",
    "withdrawn_at": "<string>",
    "asset": "<string>",
    "description": "<string>",
    "cvss_vector": "<string>",
    "attachments": {},
    "submission": {
      "submitted_at": "<string>",
      "attachments": {},
      "content": {
        "title": "<string>",
        "asset": "<string>",
        "description": "<string>",
        "cvss_vector": ""
      },
      "program": {
        "policy_version": 123,
        "name": "<string>",
        "scope": "<string>",
        "exclusions": "<string>",
        "rules": "<string>",
        "eligibility": "<string>",
        "disclosure": "<string>",
        "rewards": {}
      },
      "stripe": {
        "status": "<string>",
        "checked_at": "<string>"
      }
    },
    "decision": {
      "outcome": "accepted",
      "at": "<string>",
      "message": "<string>"
    },
    "payout": {
      "status": "approving",
      "amount_cents": 123,
      "approved_at": "<string>",
      "transferred_at": "<string>",
      "received_at": "<string>",
      "payout_failed_at": "<string>"
    }
  }
}

{
  "detail": "<string>",
  "code": "<string>",
  "current": {
    "id": "<string>",
    "program_id": "<string>",
    "program_name": "<string>",
    "status": "draft",
    "display_status": "<string>",
    "title": "<string>",
    "revision": 123,
    "created_at": "<string>",
    "updated_at": "<string>",
    "submitted_at": "<string>",
    "withdrawn_at": "<string>",
    "asset": "<string>",
    "description": "<string>",
    "cvss_vector": "<string>",
    "attachments": {},
    "submission": {
      "submitted_at": "<string>",
      "attachments": {},
      "content": {
        "title": "<string>",
        "asset": "<string>",
        "description": "<string>",
        "cvss_vector": ""
      },
      "program": {
        "policy_version": 123,
        "name": "<string>",
        "scope": "<string>",
        "exclusions": "<string>",
        "rules": "<string>",
        "eligibility": "<string>",
        "disclosure": "<string>",
        "rewards": {}
      },
      "stripe": {
        "status": "<string>",
        "checked_at": "<string>"
      }
    },
    "decision": {
      "outcome": "accepted",
      "at": "<string>",
      "message": "<string>"
    },
    "payout": {
      "status": "approving",
      "amount_cents": 123,
      "approved_at": "<string>",
      "transferred_at": "<string>",
      "received_at": "<string>",
      "payout_failed_at": "<string>"
    }
  }
}

Overview

Programs

Reports

Files

Messages

Account

API keys

Authorizations

Path Parameters

Query Parameters

Response