PUT/api/v1/jira/site

Connect the workspace's Jira site

Admins and owners: the Jira site (cloud_id, one your connection reaches), the projects on Team (projects; none: Team shows nothing from Jira), and the default project and issue type for new issues. Registers the webhooks that keep statuses in step.

API token required20 per minute per IP

Guide: Jira

Code samples and Try it

Request body

application/json, required

workspace_idstringRequired
Matches ^[0-9a-f]{24}$.
cloud_idstringRequired
1–80 characters.
projectsarray of string
Up to 20 items.
default_projectstring
Up to 20 characters.
default_issue_typestring
Up to 60 characters.

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

bash

curl -X PUT https://api.markdrop.in/api/v1/jira/site \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"workspace_id":"WORKSPACE_ID","cloud_id":"CLOUD_ID"}'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/jira/site", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "workspace_id": "WORKSPACE_ID",
    "cloud_id": "CLOUD_ID"
  }),
});
const data = await res.json();

python

import os

import requests

r = requests.put(
    "https://api.markdrop.in/api/v1/jira/site",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"workspace_id": "WORKSPACE_ID", "cloud_id": "CLOUD_ID"},
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only, and sent only to the API. Create a token

workspace_idrequired

cloud_idrequired

Show all 5 body fields

Your request

curl -X PUT https://api.markdrop.in/api/v1/jira/site \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"workspace_id":"WORKSPACE_ID","cloud_id":"CLOUD_ID"}'

This calls the live API as you. Changes are real.

I understand, send real requests from this page

Tick the box above to send. Or copy the command and run it in a terminal.

Did this page help?