openapi: 3.1.0
info:
  title: Atlassian Jira Cloud Platform REST API v3 Fields Issue Worklogs API
  description: 'Best-effort OpenAPI 3.1 description of the Atlassian Jira Cloud platform REST API

    (version 3). This spec covers a representative subset of issue, project, user,

    search, comment and workflow operations. Derived from the public developer

    documentation at https://developer.atlassian.com/cloud/jira/platform/rest/v3/.

    '
  version: '3'
  contact:
    name: Atlassian Developer
    url: https://developer.atlassian.com/cloud/jira/platform/rest/v3/
servers:
- url: https://{your-domain}.atlassian.net
  description: Jira Cloud site
  variables:
    your-domain:
      default: example
      description: Your Atlassian site domain
security:
- basicAuth: []
- OAuth2: []
tags:
- name: Issue Worklogs
  description: Manage worklogs on issues.
paths:
  /rest/api/3/issue/{issueIdOrKey}/worklog:
    post:
      tags:
      - Issue Worklogs
      summary: Add worklog
      operationId: addWorklog
      parameters:
      - $ref: '#/components/parameters/IssueIdOrKey'
      responses:
        '201':
          description: Worklog added
components:
  parameters:
    IssueIdOrKey:
      in: path
      name: issueIdOrKey
      required: true
      schema:
        type: string
      description: Numeric ID or human key of the issue
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Email + API token via HTTP Basic auth.
    OAuth2:
      type: oauth2
      description: Atlassian OAuth 2.0 (3LO) for Jira Cloud.
      flows:
        authorizationCode:
          authorizationUrl: https://auth.atlassian.com/authorize
          tokenUrl: https://auth.atlassian.com/oauth/token
          scopes:
            read:jira-work: Read Jira work
            write:jira-work: Write Jira work
            read:jira-user: Read Jira user
            manage:jira-project: Manage Jira projects