> ## Documentation Index > Fetch the complete documentation index at: https://docs.anny.co/llms.txt > Use this file to discover all available pages before exploring further. # Update a service ## OpenAPI ````yaml /developers/openapi/admin.openapi.json patch /api/v1/services/{service_slug} openapi: 3.1.0 info: title: admin-api version: '1.0' description: >- The Admin API gives you **full programmatic access** to your anny organization. It is built for **server-side integrations** — backend services, automation scripts, and custom tooling that act on behalf of your team. --- ## When to use the Admin API Use the Admin API when you need to **drive workflows from your own systems**: - **Sync membership data** — create or update customers, assign them to communities, reflect subscription status from an external CRM - **Create bookings programmatically** — build back-office tools or automate repeat reservations without going through the customer checkout - **Issue and forward invoices** — generate invoices, send them to customers, or push them to your accounting system - **React to real-time events** — pair the API with [Webhooks](/developers/guides/admin/webhooks) to trigger side effects whenever a booking is created, cancelled, or checked in - **Drive display panels** — push live occupancy and schedule data to digital signage or lobby displays Combined with [webhook subscriptions](/developers/guides/admin/webhooks), you can build fully automated, event-driven workflows without polling. --- ## Authentication Generate a long-lived API token directly in the admin dashboard under **Organization Settings → API**. All requests require it in the `Authorization` header: ``` Authorization: Bearer {access_token} ``` Every endpoint is **organization-scoped**. Pass your organization ID as a query parameter on every request: ``` ?o={organization_id} ``` See the [Authentication guide](/developers/guides/authentication) for token scopes and the full OAuth2 flow. --- ## Admin API vs Customer API | | Admin API | Customer API | |---|---|---| | **Use case** | Server-side automation, backend tooling | End-user apps, booking widgets | | **Auth** | Required — API token or OAuth2 | Optional — many endpoints work without a token | | **Identifiers** | Immutable UUIDs and integer IDs | Slugs, booking numbers, order numbers | | **Access** | Full read/write | Public and customer-owned data only | → [Go to the Customer API](/developers/api-reference/customer) --- ## Resource Identifiers The Admin API uses **immutable IDs** — UUIDs for most entities, integers for legacy ones. These are safe to store in external systems and never change, even if an organization renames a resource. --- ## Starting Points | Guide | What it covers | |---|---| | [Getting Started](/developers) | First steps and quickstart | | [JSON:API Conventions](/developers/guides/json-api-conventions) | Request and response format | | [Authentication](/developers/guides/authentication) | API tokens, OAuth2, scopes | | [Availability & Booking Search](/developers/guides/availability) | Search open slots and timeslots | | [Admin Booking Creation](/developers/guides/admin/booking-creation) | Create bookings from the back office | | [Admin Booking Lifecycle](/developers/guides/admin/booking-lifecycle) | Status changes, check-in, cancellations | | [Invoices](/developers/guides/admin/invoices) | Create, send, and manage invoices | | [Customer Management](/developers/guides/admin/customer-management) | Create and manage customer records | | [Booking Calendars](/developers/guides/admin/calendar-events) | Custom calendar events | | [Timeslot Management](/developers/guides/admin/timeslot-management) | Manage timeslot CRUD, recurrence, allocations, and rescheduling | | [Broadcast Campaigns](/developers/guides/admin/broadcasting) | Email and push campaigns | | [Exports](/developers/guides/admin/exports) | Export bookings and customer data | | [Webhooks & Events](/developers/guides/admin/webhooks) | Subscribe to real-time events | --- ## Base URLs | Environment | URL | |---|---| | Production | `https://b.anny.co` | | Gov-Cloud | `https://b.anny.eu` | contact: name: anny GmbH url: https://anny.co email: support@anny.co servers: - url: https://b.anny.co description: Production - url: https://b.anny.eu description: Gov-Cloud security: - Bearer: [] tags: - name: Add-On Groups - name: Add-Ons - name: Booking Add-Ons - name: Booking Bundles - name: Booking Passes - name: Booking Quota Grants - name: Booking Quotas - name: Booking Rules - name: Bookings - name: Broadcast Campaigns - name: Broadcasts - name: Calendars - name: Cancellation Policies - name: Communities - name: External Links - name: Community Invites - name: Custom Fields - name: Custom Forms - name: Customers - name: Businesses - name: Display Panels - name: Displays - name: Document Templates - name: Exports - name: External Calendars - name: Files - name: Images - name: Invoices - name: Items - name: Legal Document Links - name: Legal Documents - name: Model Identifiers - name: Orders - name: Organizations - name: Payment Setups - name: Payments - name: Plan Subscriptions - name: Price Modifiers - name: Properties - name: Queues - name: Resource Categories - name: Resource Groups - name: Resource Properties - name: Resources - name: Scans - name: Schedule Groups - name: Schedules - name: Service Add-Ons - name: Service Groups - name: Services - name: Sub-Resources - name: Test-Results - name: Test Results - name: Tests - name: Timeslot Allocations - name: Timeslot Series - name: Timeslots - name: User Invites - name: Users - name: Customer Balances - name: Vouchers - name: Webhooks paths: /api/v1/services/{service_slug}: parameters: - schema: type: string name: service_slug in: path required: true patch: tags: - Services summary: Update a service operationId: patch-services-record parameters: - schema: type: string in: query name: o description: Organization ID requestBody: content: application/vnd.api+json: schema: type: object properties: data: $ref: '#/components/schemas/services.v1' examples: default: value: data: id: '2777' type: services attributes: name: Basic relationships: {} responses: '200': description: OK content: application/vnd.api+json: schema: type: object properties: data: $ref: '#/components/schemas/services.v1' examples: default: value: data: type: services id: '2777' attributes: name: Basic slug: mvwps18k7e0lifyxl7icid4znqdcwq description: null hidden: false is_rental_option: true has_flexible_duration: true auto_duration: false allow_cross_schedule: false requires_booking_description: false requires_address: true requires_mobile: true allow_customer_notes: true allow_more_bookings: true charge_off_schedule: true booking_interval: 15 calculation_interval: 30 min_duration: 30 max_duration: 480 uncharged_duration: 60 is_full_day: false lead_time: 60 padding_before: 15 padding_after: 15 advance_booking_period: 31 price: 3 starting_fee: 10 currency: EUR tax_rate: 19 is_net_price: false price_hidden: false default_weight: 1 created_at: '2021-09-20T13:42:16+00:00' updated_at: '2021-10-26T09:29:24+00:00' access_code: null settings: payment: isEnabled: false allowOffline: false flow: pay-offline email_info: null links: self: https://b.anny.co/api/v1/services/2777 meta: resource_list: C01 - London, M01 - Aachen, M02 - Köln min_duration_total: 10 '401': description: Unauthorized '404': description: Not Found security: - Bearer: [] components: schemas: services.v1: $schema: https://json-schema.org/draft/2020-12/schema x-version: 1.1.0 title: Service type: object description: >- A bookable service offered on one or more resources. Defines pricing, duration, and booking rules. x-tags: - Models properties: id: type: string type: type: string default: services attributes: type: object properties: name: type: string description: Service name local_name: type: string description: Localized name slug: type: string description: URL-friendly slug description: type: - string - 'null' description: Rich text description plain_description: type: - string - 'null' description: Plain text description email_info: type: - string - 'null' description: Email info text x-visibility: admin duration: type: integer description: Duration in minutes lead_time: type: integer description: Buffer time before booking in minutes follow_up_time: type: integer description: Buffer time after booking in minutes min_advance_time: type: integer description: Minimum advance booking time in minutes max_advance_time: type: integer description: Maximum advance booking time in minutes min_duration: type: integer description: Minimum duration for flexible bookings max_duration: type: integer description: Maximum duration for flexible bookings currency: type: string description: ISO 4217 currency code price: type: number description: Base price is_net_price: type: boolean description: Whether price is net price_hidden: type: boolean description: Whether to hide prices price_label: type: - string - 'null' description: Custom price label tax_rate: type: number description: Tax rate unit: type: string description: Pricing unit calculation_unit: type: string description: Calculation unit for pricing booking_type: type: string description: Type of booking flow is_protected: type: boolean description: Whether admin-only booking allow_personalization: type: boolean description: Whether personalization is supported require_personalization: type: boolean description: Whether personalization is required allow_participants: type: boolean description: Whether participants are supported allow_resource_selection: type: boolean description: Whether customer can choose resource allow_recurring: type: boolean description: Whether recurring bookings are supported auto_accept_bookings: type: boolean description: Whether bookings are auto-accepted requires_quota: type: boolean description: Whether a quota pass is required min_booking_quantity: type: integer description: Minimum booking quantity max_booking_quantity: type: integer description: Maximum booking quantity quota: type: integer description: Default slot capacity archived: type: boolean description: Whether archived x-visibility: admin hidden_in_list: type: boolean description: Hidden from service list x-visibility: admin public_listing: type: boolean description: Listed in public directory x-visibility: admin assignment_strategy: type: string description: Resource assignment strategy x-visibility: admin settings: type: object description: Service settings x-visibility: admin created_at: type: string description: Creation timestamp updated_at: type: string description: Last update timestamp links: $ref: '#/components/schemas/links.v1' relationships: type: object properties: organization: type: object description: Owning organization properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' cover_image: type: object description: Cover image properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' resources: type: object description: Resources this service is offered on properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' recommended_resources: type: object description: Recommended resources properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' add_ons: type: object description: Available add-ons properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' service_add_ons: type: object description: Service-add-on pivot properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' cancellation_policy: type: object description: Cancellation policy properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' legal_document_links: type: object description: Required legal documents properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' custom_form_models: type: object description: Custom checkout forms properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' schedules: type: object description: Custom schedules properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' communities: type: object description: Associated communities properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' group: type: object description: Service group properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' price_modifiers: type: object description: Price modifiers properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' links.v1: $schema: https://json-schema.org/draft/2020-12/schema x-version: 1.1.0 title: ResourceLinks x-tags: - Models type: object description: JSON:API self-link object properties: self: type: string format: uri securitySchemes: Bearer: type: oauth2 flows: authorizationCode: authorizationUrl: https://auth.anny.co/oauth/authorize tokenUrl: https://auth.anny.co/oauth/token refreshUrl: https://auth.anny.co/oauth/token/refresh scopes: {} ````