> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yoid.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a new presentation



## OpenAPI

````yaml me-creds POST /presentations/request
openapi: 3.0.0
info:
  version: 1.0.0
  title: Me Creds API
  description: >2-

          
    OpenAPI documentation for Me Creds API

          
      
    Following JSON:API spec https://jsonapi.org/format/ approach to response
    payload format.

          
     - [JSON - OpenAPI Specification](/me-creds/api/openapi.json)
servers:
  - url: https://test.didxtech.com/me-creds/api
    description: Test environment
security:
  - bearerAuth: []
paths:
  /presentations/request:
    post:
      tags:
        - presentations
      summary: Create a new presentation
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePresentationRequestDto'
      responses:
        '200':
          description: Presentation created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PresentationRequestApiResponse'
components:
  schemas:
    CreatePresentationRequestDto:
      type: object
      properties:
        presentationTemplateId:
          type: string
      required:
        - presentationTemplateId
      example:
        presentationTemplateId: cm2ytsdid009u4ke3t30aiuvc
    PresentationRequestApiResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/PresentationRequestDto'
        links:
          $ref: '#/components/schemas/ApiLinks'
        meta:
          $ref: '#/components/schemas/ApiMeta'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ApiError'
      required:
        - data
    PresentationRequestDto:
      type: object
      properties:
        id:
          type: string
        createdAt:
          type: string
        updatedAt:
          type: string
        status:
          type: string
        error:
          type: string
          nullable: true
        presentationTemplateId:
          type: string
        credentials:
          type: array
          items:
            $ref: '#/components/schemas/CredentialDto'
        expiresAt:
          type: string
        authorizationRequestUri:
          type: string
          format: uri
        authorizationRequestQrUri:
          type: string
          format: uri
      required:
        - id
        - createdAt
        - updatedAt
        - status
        - error
        - presentationTemplateId
        - credentials
        - expiresAt
        - authorizationRequestUri
        - authorizationRequestQrUri
      example:
        id: cmbhsgi6c00cls60120oyb8tl
        createdAt: '2025-06-04T10:12:20.101Z'
        updatedAt: '2025-06-04T10:12:20.101Z'
        status: requested
        error: null
        presentationTemplateId: cma2nw2vd00sos601irn14wt1
        credentials:
          - isValid: true
            name: Identity
            type: https://metadata.paradym.id/types/pHXnPey2Uu-identity
            attributes:
              name: Johny
              surname: Postman
            issues: []
        expiresAt: '2025-07-04T10:12:20.088Z'
        authorizationRequestUri: >-
          https://paradym.id/invitation?request_uri=https%3A%2F%2Fparadym.id%2Finvitation%2F421b518d-ad91-4802-ab25-3a83c9f7f44e%2Fauthorization-requests%2F92c2b88e-9a3d-4ca4-a33f-8687588d0f6b%3Fraw%3Dtrue&client_id=did%3Aweb%3Ametadata.paradym.id%3A3c9d79ef-6aca-4f3e-b2ab-1f2933b7fe90
        authorizationRequestQrUri: >-
          https://paradym.id/invitation?request_uri=https%3A%2F%2Fparadym.id%2Finvitation%2F421b518d-ad91-4802-ab25-3a83c9f7f44e%2Fauthorization-requests%2F92c2b88e-9a3d-4ca4-a33f-8687588d0f6b%3Fraw%3Dtrue&qr=true
    ApiLinks:
      type: object
      properties:
        self:
          type: string
          format: uri
        first:
          type: string
          format: uri
        last:
          type: string
          format: uri
        prev:
          type: string
          format: uri
        next:
          type: string
          format: uri
        related:
          type: string
          format: uri
    ApiMeta:
      type: object
      additionalProperties:
        nullable: true
    ApiError:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
        code:
          type: string
        title:
          type: string
        detail:
          type: string
        source:
          type: object
          properties:
            pointer:
              type: string
            parameter:
              type: string
        meta:
          type: object
          additionalProperties:
            nullable: true
      required:
        - detail
    CredentialDto:
      type: object
      properties:
        isValid:
          type: boolean
        name:
          type: string
        type:
          type: string
        attributes:
          type: object
          additionalProperties:
            nullable: true
        issues:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorDto'
      required:
        - isValid
        - name
        - type
        - attributes
        - issues
      example:
        isValid: true
        name: Identity
        type: https://metadata.paradym.id/types/pHXnPey2Uu-identity
        attributes:
          name: Johny
          surname: Postman
        issues: []
    ValidationErrorDto:
      type: object
      properties:
        type:
          type: string
          enum:
            - EXPIRED
            - INVALID_CREDENTIAL
            - NOT_YET_VALID
            - UNKNOWN
        message:
          type: string
        details:
          type: object
          additionalProperties:
            nullable: true
      required:
        - type
        - message
      example:
        type: EXPIRED
        message: Credential has expired
        details:
          expirationTime: 1908230400
          currentTime: 1908230500
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````