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

> ## Agent Instructions
> Treat Stackdome as an application-delivery platform for coding agents and developers, not as a Kubernetes dashboard.
> Prefer the Stackdome agent plugin as the user entry point and the stackdome CLI as the execution interface.
> Route agents who need the maintained deploy skill to npx skills add stackdome/skills and the complete operational workflow to /guides/ai-agents.
> Verify commands and flags with stackdome --help. Run stackdome init before authoring stackfile.yaml and stackdome validate before deploying.
> Use -o json for automation and verify documented terminal states before claiming success.
> Never request a user's account password. Use API-token authentication.
> During alpha, Stackdome Cloud is ephemeral and capacity-limited, and each organization can connect one cluster.
> Do not expose Kubernetes as a user concern unless the task is self-hosting or infrastructure architecture.

# Restart a stack resource

> Triggers a rolling restart of the stack resource by setting a new restart request timestamp.



## OpenAPI

````yaml /openapi.yaml post /api/v1/organizations/{org_id}/projects/{project_name}/stacks/{id}/resources/{resource_name}/actions/restart
openapi: 3.0.0
info:
  description: >-
    Deploy, debug, and operate applications through the Stackdome REST API on
    Stackdome Cloud or a self-hosted installation. This API is in alpha and may
    change before general availability.
  title: Stackdome API
  version: 0.0.1-alpha
servers:
  - url: /
security: []
paths:
  /api/v1/organizations/{org_id}/projects/{project_name}/stacks/{id}/resources/{resource_name}/actions/restart:
    post:
      summary: Restart a stack resource
      description: >-
        Triggers a rolling restart of the stack resource by setting a new
        restart request timestamp.
      parameters:
        - description: The ID of the organization
          explode: false
          in: path
          name: org_id
          required: true
          schema:
            type: string
          style: simple
        - description: The name of the project
          explode: false
          in: path
          name: project_name
          required: true
          schema:
            type: string
          style: simple
        - description: The id of record
          explode: false
          in: path
          name: id
          required: true
          schema:
            type: string
          style: simple
        - description: The name of the stack resource
          explode: false
          in: path
          name: resource_name
          required: true
          schema:
            type: string
          style: simple
      responses:
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StackResource'
          description: Restart initiated
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Stack resource not found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal server error
      security:
        - Bearer: []
components:
  schemas:
    StackResource:
      example:
        outputs:
          - name: name
            sensitive: true
            type: string
          - name: name
            sensitive: true
            type: string
        depends_on:
          - depends_on
          - depends_on
        replicas: 0
        annotations:
          - value: value
            key: key
          - value: value
            key: key
        init_spec:
          args:
            - args
            - args
          command:
            - command
            - command
        execution_config:
          args:
            - args
            - args
          environment_variables:
            - name: name
              self_output: self_output
              value: value
            - name: name
              self_output: self_output
              value: value
          command:
            - command
            - command
        volume_mounts:
          - stack_resource_id: stack_resource_id
            source_volume_name: source_volume_name
            source_volume_type: null
            source_sub_path: source_sub_path
            target_path: target_path
          - stack_resource_id: stack_resource_id
            source_volume_name: source_volume_name
            source_volume_type: null
            source_sub_path: source_sub_path
            target_path: target_path
        source:
          volume:
            volume_id: volume_id
            current_volume_hash: current_volume_hash
            volume_name: volume_name
            build_context: .
            dockerfile_path: Dockerfile
          image:
            ref: ref
            registry_credentials_id: registry_credentials_id
          git:
            repo_url: repo_url
            integration_id: integration_id
            commit: commit
            build_context: .
            tag: tag
            dockerfile_path: Dockerfile
            branch: branch
            push:
              registry_credentials_id: registry_credentials_id
              repository: repository
        ports:
          - number: 0
            protocol: protocol
            exposed_to_public: true
            name: name
            subdomain_prefix: subdomain_prefix
          - number: 0
            protocol: protocol
            exposed_to_public: true
            name: name
            subdomain_prefix: subdomain_prefix
        workload_type: Service
        labels:
          - value: value
            key: key
          - value: value
            key: key
        revision: revision
        schedule: schedule
        stack_id: stack_id
        name: name
        lifecycle_config:
          restart_request_time: '2000-01-23T04:56:07.000Z'
        id: id
      properties:
        id:
          readOnly: true
          type: string
        stack_id:
          readOnly: true
          type: string
        name:
          type: string
        labels:
          items:
            $ref: '#/components/schemas/Label'
          type: array
        annotations:
          items:
            $ref: '#/components/schemas/Annotation'
          type: array
        revision:
          readOnly: true
          type: string
        source:
          $ref: '#/components/schemas/SourceSpec'
        init_spec:
          $ref: '#/components/schemas/InitSpec'
        execution_config:
          $ref: '#/components/schemas/ExecutionConfig'
        volume_mounts:
          items:
            $ref: '#/components/schemas/VolumeMount'
          type: array
        depends_on:
          items:
            type: string
          type: array
        lifecycle_config:
          $ref: '#/components/schemas/LifecycleConfig'
        ports:
          items:
            $ref: '#/components/schemas/Port'
          type: array
        outputs:
          items:
            $ref: '#/components/schemas/OutputDescriptor'
          readOnly: true
          type: array
        workload_type:
          default: Service
          enum:
            - Service
            - StatefulService
            - Worker
            - Job
            - CronJob
          type: string
        schedule:
          type: string
        replicas:
          format: int32
          minimum: 0
          type: integer
      required:
        - name
      type: object
    Error:
      allOf:
        - $ref: '#/components/schemas/ObjectReference'
        - $ref: '#/components/schemas/Error_allOf'
    Label:
      additionalProperties: false
      example:
        value: value
        key: key
      properties:
        key:
          type: string
        value:
          type: string
      required:
        - key
        - value
      type: object
    Annotation:
      example:
        value: value
        key: key
      properties:
        key:
          type: string
        value:
          type: string
      required:
        - key
        - value
      type: object
    SourceSpec:
      additionalProperties: false
      description: >-
        Where a stack resource's runtime image comes from. Exactly one of git,
        image, or volume must be set (enforced server-side).
      example:
        volume:
          volume_id: volume_id
          current_volume_hash: current_volume_hash
          volume_name: volume_name
          build_context: .
          dockerfile_path: Dockerfile
        image:
          ref: ref
          registry_credentials_id: registry_credentials_id
        git:
          repo_url: repo_url
          integration_id: integration_id
          commit: commit
          build_context: .
          tag: tag
          dockerfile_path: Dockerfile
          branch: branch
          push:
            registry_credentials_id: registry_credentials_id
            repository: repository
      properties:
        git:
          $ref: '#/components/schemas/GitSource'
        image:
          $ref: '#/components/schemas/ImageSource'
        volume:
          $ref: '#/components/schemas/VolumeBuildSource'
      type: object
    InitSpec:
      additionalProperties: false
      example:
        args:
          - args
          - args
        command:
          - command
          - command
      properties:
        command:
          items:
            type: string
          type: array
        args:
          items:
            type: string
          type: array
      type: object
    ExecutionConfig:
      example:
        args:
          - args
          - args
        environment_variables:
          - name: name
            self_output: self_output
            value: value
          - name: name
            self_output: self_output
            value: value
        command:
          - command
          - command
      properties:
        command:
          items:
            type: string
          type: array
        args:
          items:
            type: string
          type: array
        environment_variables:
          items:
            $ref: '#/components/schemas/EnvVar'
          type: array
      type: object
    VolumeMount:
      example:
        stack_resource_id: stack_resource_id
        source_volume_name: source_volume_name
        source_volume_type: null
        source_sub_path: source_sub_path
        target_path: target_path
      properties:
        stack_resource_id:
          readOnly: true
          type: string
        source_volume_type:
          $ref: '#/components/schemas/VolumeMountSourceType'
        source_volume_name:
          type: string
        source_sub_path:
          type: string
        target_path:
          type: string
      required:
        - source_volume_name
        - target_path
      type: object
    LifecycleConfig:
      example:
        restart_request_time: '2000-01-23T04:56:07.000Z'
      properties:
        restart_request_time:
          format: date-time
          type: string
      type: object
    Port:
      example:
        number: 0
        protocol: protocol
        exposed_to_public: true
        name: name
        subdomain_prefix: subdomain_prefix
      properties:
        name:
          type: string
        number:
          type: integer
        protocol:
          type: string
        exposed_to_public:
          type: boolean
        subdomain_prefix:
          type: string
      required:
        - exposed_to_public
        - name
        - number
      type: object
    OutputDescriptor:
      description: >-
        Declared output metadata for a topology node. Values are not returned
        here.
      example:
        name: name
        sensitive: true
        type: string
      properties:
        name:
          description: Stable output accessor name, for example `host` or `public_url`.
          type: string
        type:
          description: Scalar value type exposed by this output.
          enum:
            - string
            - integer
            - boolean
          type: string
        sensitive:
          description: >-
            True when the output value is sensitive and should never be returned
            in normal metadata APIs.
          type: boolean
      required:
        - name
        - sensitive
        - type
      type: object
    ObjectReference:
      properties:
        id:
          type: string
        kind:
          type: string
        href:
          type: string
      type: object
    Error_allOf:
      properties:
        code:
          type: string
        reason:
          type: string
        operation_id:
          type: string
        details:
          additionalProperties: true
          description: Optional structured, machine-readable error context
          type: object
      type: object
    GitSource:
      additionalProperties: false
      example:
        repo_url: repo_url
        integration_id: integration_id
        commit: commit
        build_context: .
        tag: tag
        dockerfile_path: Dockerfile
        branch: branch
        push:
          registry_credentials_id: registry_credentials_id
          repository: repository
      properties:
        repo_url:
          type: string
        branch:
          description: >-
            Defaults to the repository's default branch, resolved and stored at
            create time
          type: string
        tag:
          description: Mutually exclusive with branch
          type: string
        commit:
          description: Commit SHA pin; requires branch or tag
          type: string
        dockerfile_path:
          default: Dockerfile
          type: string
        build_context:
          default: .
          type: string
        integration_id:
          description: Org-level git integration override for clone auth
          type: string
        push:
          $ref: '#/components/schemas/PushTarget'
      required:
        - repo_url
      type: object
    ImageSource:
      additionalProperties: false
      example:
        ref: ref
        registry_credentials_id: registry_credentials_id
      properties:
        ref:
          type: string
        registry_credentials_id:
          description: Org-level registry credential override for pull auth
          type: string
      required:
        - ref
      type: object
    VolumeBuildSource:
      additionalProperties: false
      example:
        volume_id: volume_id
        current_volume_hash: current_volume_hash
        volume_name: volume_name
        build_context: .
        dockerfile_path: Dockerfile
      properties:
        volume_id:
          type: string
        volume_name:
          description: >-
            Name of a volume defined on the stack; either volume_id or
            volume_name is required
          type: string
        current_volume_hash:
          description: Content hash of the volume used as the build source revision
          type: string
        dockerfile_path:
          default: Dockerfile
          type: string
        build_context:
          default: .
          type: string
      type: object
    EnvVar:
      additionalProperties: false
      example:
        name: name
        self_output: self_output
        value: value
      properties:
        name:
          type: string
        value:
          description: Literal environment variable value.
          type: string
        self_output:
          description: >-
            Read this environment variable from one of the resource's own
            declared outputs, for example public_url.
          type: string
      required:
        - name
      type: object
    VolumeMountSourceType:
      enum:
        - EmptyVolume
        - RemoteDirSyncedVolume
        - BuildArtifactSyncedVolume
        - GitRepoSyncedVolume
      type: string
    PushTarget:
      additionalProperties: false
      example:
        registry_credentials_id: registry_credentials_id
        repository: repository
      properties:
        repository:
          description: Push repository as host/path, without a tag
          type: string
        registry_credentials_id:
          description: Org-level registry credential override for push auth
          type: string
      required:
        - repository
      type: object
  securitySchemes:
    Bearer:
      bearerFormat: JWT
      scheme: bearer
      type: http

````