Content

Queue async post generation

Changed on

Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.

post/v1/posts/generate

Request

  • Base URL: https://api.usenotra.com
  • URL: https://api.usenotra.com/v1/posts/generate
  • Auth: HTTP bearer

Request body

contentType'changelog' | 'blog_post' | 'linkedin_post' | 'twitter_post' | 'image' required

Type of content to generate.

lookbackWindow'current_day' | 'yesterday' | 'last_7_days' | 'last_14_days' | 'last_30_days'

How far back to collect source activity (commits, pull requests, releases, Linear issues).

brandVoiceIdstring

Deprecated. Use brandIdentityId instead.

brandIdentityIdstring nullable

Brand identity to write in. Defaults to the organization's default brand identity.

repositoryIdsstring[]

Deprecated. Use integrations.github with GitHub integration IDs instead.

linearIntegrationIdsstring[]

Deprecated. Use integrations.linear with Linear integration IDs instead.

timezonestring

IANA timezone used for relative lookback windows such as current_day and yesterday.

Example request

{
  "contentType": "blog_post",
  "lookbackWindow": "last_7_days",
  "brandVoiceId": "51c2f3aa-efdd-4e28-8e69-23fa2dfd3561",
  "brandIdentityId": "51c2f3aa-efdd-4e28-8e69-23fa2dfd3561",
  "repositoryIds": [
    "repo_1",
    "repo_2"
  ],
  "linearIntegrationIds": [
    "linear_integration_1"
  ],
  "integrations": {
    "github": [
      "integration_1",
      "integration_2"
    ],
    "linear": [
      "linear_integration_1"
    ]
  },
  "github": {
    "repositories": [
      {
        "owner": "usenotra",
        "repo": "notra"
      }
    ]
  },
  "timezone": "America/New_York"
}

Response

Post generation queued successfully

Changes