POST/api/v1/jira/pages/{slug}/list

One page of a Jira list

Runs a list block's query (jql, project or filter) as you, through your own Jira: nobody sees an issue their Jira hides. Readers can run only the lists saved on the page; editors can preview a new one. page_token (the previous answer's next) for the next page.

API token required120 per minute per IP

Guide: Jira in pages

Code samples and Try it

Path parameters

#
  • slugstringRequired

    The document's address: the part after markdrop.in/.

Headers

#
  • X-Read-Passwordstring

    The password of a password-protected document.

  • X-Markdrop-Workspacestring

    A workspace's id: answer only if the document is in that workspace, else 404. Workspace domains send it; you rarely need it.

Request body

#

application/json, required

  • jqlstring

    Up to 1,500 characters.

  • projectstring

    Up to 20 characters.

  • filterstring

    Up to 12 characters.

  • sitestring

    Matches ^[A-Za-z0-9:/._-]{3,200}$.

  • colsarray of string

    Up to 10 items.

  • limitinteger

    From 1 to 100.

  • titlestring

    Shown on the page and in link previews. Up to 200 characters.

  • page_tokenstring

    Up to 2,000 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.
Did this page help?