Grigora API

openapi: 3.1.0
info:
  title: Grigora API
  version: '2026-11-10'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-10: 8 operation(s) read from 4 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Grigora has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 7
    pages-with-code: 1
    pages-read: 4
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-10'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://help.grigora.co/developers/api-reference
  - https://www.grigora.co/tools/pinterest-pin-title-generator
  - https://www.grigora.co/tools/pinterest-description-generator
  - https://help.grigora.co/developers/creating-and-authorizing-an-api-key
servers:
- url: https://api.grigora.co
paths:
  /cms/post/create:
    post:
      operationId: post_cms_post_create
      tags:
      - Cms
      summary: Create Post
      x-source: https://help.grigora.co/developers/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCmsPostCreateRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCmsPostCreateResponse'
      x-evidence:
        kind: documentation
  /cms/post/delete:
    post:
      operationId: post_cms_post_delete
      tags:
      - Cms
      summary: Delete Post
      x-source: https://help.grigora.co/developers/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCmsPostDeleteRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCmsPostDeleteResponse'
      x-evidence:
        kind: documentation
  /cms/post/list:
    post:
      operationId: post_cms_post_list
      tags:
      - Cms
      summary: List Posts
      x-source: https://help.grigora.co/developers/api-reference
      parameters:
      - name: filters
        in: query
        required: false
        schema:
          type: object
        description: An object containing key-value pairs to filter the posts.
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: The field to sort the results by (e.g., last_update , title ).
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: The sort order. Can be asc (ascending) or dsc (descending).
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCmsPostListResponse'
      x-evidence:
        kind: documentation
  /cms/post/publish:
    post:
      operationId: post_cms_post_publish
      tags:
      - Cms
      summary: Publish Post
      x-source: https://help.grigora.co/developers/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCmsPostPublishRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCmsPostPublishResponse'
      x-evidence:
        kind: documentation
  /cms/post/unpublish:
    post:
      operationId: post_cms_post_unpublish
      tags:
      - Cms
      summary: Unpublish Post
      x-source: https://help.grigora.co/developers/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCmsPostUnpublishRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCmsPostUnpublishResponse'
      x-evidence:
        kind: documentation
  /cms/post/update:
    post:
      operationId: post_cms_post_update
      tags:
      - Cms
      summary: Update Post
      x-source: https://help.grigora.co/developers/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCmsPostUpdateRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCmsPostUpdateResponse'
      x-evidence:
        kind: documentation
  /general/api/v1/{endpoint}:
    get:
      operationId: get_general_api_v1_endpoint
      tags:
      - General
      summary: GET /general/api/v1/{endpoint}
      x-source: https://help.grigora.co/developers/creating-and-authorizing-an-api-key
      parameters:
      - name: endpoint
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET \"https://api.grigora.co/general/api/v1/{endpoint}\" \\ -H \"Authorization: YOUR_API_KEY\" \n Replace YOUR_API_KEY\
          \ with the key you copied earlier and {endpoint} with the specific API endpoint you wish to access. Your API key is now authorized.\
          \ See the API reference guides for available endpoints and request details. \n Was this help guide helpful? Next → API Reference On\
          \ this page Generating"
  /v5/pins/{pinId}:
    get:
      operationId: get_v5_pins_pinId
      tags:
      - Pins
      summary: Confirm via GET /v5/pins/{pin_id} that the title field was indexed correctly.
      x-source: https://www.grigora.co/tools/pinterest-pin-title-generator
      parameters:
      - name: pinId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostCmsPostCreateRequest:
      type: object
      properties:
        title:
          type: string
          description: The title of the post.
        slug:
          type: string
          description: The URL-friendly identifier.
        content:
          type: string
          description: The full content of the post in a raw format.
        author:
          type: string
          description: The author's identifier.
        status:
          type: string
          description: The status of the post (e.g., draft , published ).
        category:
          type: array
          description: An array of category objects.
        tag:
          type: array
          description: An array of tag objects.
        seo_meta_title:
          type: string
        seo_meta_desc:
          type: string
        featured_image:
          type: string
        summary:
          type: string
        keyword:
          type: string
      required:
      - title
    PostCmsPostCreateResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          description: Contains id, slug, project_id.
    PostCmsPostDeleteRequest:
      type: object
      properties:
        post_id:
          type: string
          description: The unique identifier of the post to delete.
      required:
      - post_id
    PostCmsPostDeleteResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          description: Contains deleted_post_id, project_id.
    PostCmsPostListResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: array
          description: Array of post objects.
    PostCmsPostPublishRequest:
      type: object
      properties:
        post_id:
          type: array
          description: Array of unique identifiers for the posts to publish.
      required:
      - post_id
    PostCmsPostPublishResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          description: Contains published_post_ids, already_published_post_ids, queue_id, project_id, first_published.
    PostCmsPostUnpublishRequest:
      type: object
      properties:
        post_id:
          type: string
          description: The unique identifier of the post to unpublish.
      required:
      - post_id
    PostCmsPostUnpublishResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          description: Contains post_id, project_id.
    PostCmsPostUpdateRequest:
      type: object
      properties:
        post_id:
          type: string
          description: The unique identifier of the post to update.
        title:
          type: string
          description: The new title of the post.
        slug:
          type: string
          description: The new URL-friendly identifier.
        content:
          type: string
          description: The new full content of the post.
      required:
      - post_id
    PostCmsPostUpdateResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          description: Contains id, slug, project_id.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
security:
- apiKey: []
tags:
- name: Cms
- name: General
- name: Pins