> ## Documentation Index > Fetch the complete documentation index at: https://mintlify-poc.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Stop a Service > Stops a running service within a project. This is an asynchronous operation. ## OpenAPI ````yaml /api-reference/tiger-cloud-rest-api/openapi.yaml post /projects/{project_id}/services/{service_id}/stop openapi: 3.0.3 info: title: Tiger Cloud API description: | A RESTful API for Tiger Cloud. version: 1.0.0 license: name: Proprietary url: https://www.tigerdata.com/legal/terms contact: name: Tiger Data Support url: https://www.tigerdata.com/contact servers: - url: https://console.cloud.timescale.com/public/api/v1 description: API server for Tiger Cloud - url: http://localhost:8080 description: Local development server security: - basicAuth: [] tags: - name: Auth description: Authentication and authorization information. - name: VPCs description: Manage VPCs and their peering connections. - name: Services description: Manage services, read replicas, and their associated actions. - name: Analytics description: Track analytics events. paths: /projects/{project_id}/services/{service_id}/stop: post: tags: - Services summary: Stop a Service description: >- Stops a running service within a project. This is an asynchronous operation. parameters: - $ref: '#/components/parameters/ProjectId' - $ref: '#/components/parameters/ServiceId' responses: '202': description: Service stop request has been accepted. content: application/json: schema: $ref: '#/components/schemas/Service' 4XX: $ref: '#/components/responses/ClientError' components: parameters: ProjectId: name: project_id in: path required: true description: The unique identifier of the project. schema: type: string example: rp1pz7uyae ServiceId: name: service_id in: path required: true description: The unique identifier of the service. schema: type: string example: d1k5vk7hf2 schemas: Service: type: object properties: service_id: type: string description: The unique identifier for the service. project_id: type: string description: The project this service belongs to. name: type: string description: The name of the service. region_code: type: string description: The cloud region where the service is hosted. example: us-east-1 service_type: $ref: '#/components/schemas/ServiceType' description: The type of the service. created: type: string format: date-time description: Creation timestamp initial_password: type: string description: The initial password for the service. format: password example: a-very-secure-initial-password paused: type: boolean description: Whether the service is paused status: $ref: '#/components/schemas/DeployStatus' description: Current status of the service resources: type: array description: List of resources allocated to the service items: type: object properties: id: type: string description: Resource identifier spec: type: object description: Resource specification properties: cpu_millis: type: integer description: CPU allocation in millicores memory_gbs: type: integer description: Memory allocation in gigabytes volume_type: type: string description: Type of storage volume metadata: type: object description: Additional metadata for the service properties: environment: type: string description: Environment tag for the service endpoint: $ref: '#/components/schemas/Endpoint' vpcEndpoint: type: object nullable: true description: VPC endpoint configuration if available forked_from: $ref: '#/components/schemas/ForkSpec' ha_replicas: $ref: '#/components/schemas/HAReplica' connection_pooler: $ref: '#/components/schemas/ConnectionPooler' read_replica_sets: type: array items: $ref: '#/components/schemas/ReadReplicaSet' ServiceType: type: string enum: - TIMESCALEDB - POSTGRES - VECTOR DeployStatus: type: string enum: - QUEUED - DELETING - CONFIGURING - READY - DELETED - UNSTABLE - PAUSING - PAUSED - RESUMING - UPGRADING - OPTIMIZING Endpoint: type: object properties: host: type: string example: my-service.com port: type: integer example: 8080 ForkSpec: type: object properties: project_id: type: string example: asda1b2c3 service_id: type: string example: bbss422fg is_standby: type: boolean example: false HAReplica: type: object properties: sync_replica_count: type: integer description: Number of synchronous high-availability replicas. example: 1 replica_count: type: integer description: >- Number of high-availability replicas (all replicas are asynchronous by default). example: 1 ConnectionPooler: type: object properties: endpoint: $ref: '#/components/schemas/Endpoint' ReadReplicaSet: type: object properties: id: type: string example: alb8jicdpr name: type: string example: reporting-replica-1 status: type: string enum: - creating - active - resizing - deleting - error example: active nodes: type: integer description: Number of nodes in the replica set. example: 2 cpu_millis: type: integer description: CPU allocation in milli-cores. example: 250 memory_gbs: type: integer description: Memory allocation in gigabytes. example: 1 metadata: type: object description: Additional metadata for the read replica set properties: environment: type: string description: Environment tag for the read replica set endpoint: $ref: '#/components/schemas/Endpoint' connection_pooler: $ref: '#/components/schemas/ConnectionPooler' Error: type: object properties: code: type: string message: type: string responses: ClientError: description: Client error response (4xx status codes). content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: basicAuth: type: http scheme: basic description: > HTTP Basic Authentication using your Tiger Cloud public key and secret key. Format: `Authorization: Basic ` Example: ```bash curl -X GET "https://console.cloud.timescale.com/public/api/v1/projects/{project_id}/services" \ -H "Authorization: Basic $(echo -n 'your_public_key:your_secret_key' | base64)" ``` ````