Skip to content
/
Updates timeshift

TIMIFY Developer API GraphQL Proxy (0.0.4)

HTTP proxy API in front of TIMIFY GraphQL services. Generated from Express routes and route analysis docs.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
TIMIFY API Team
developers@timify.com
Languages
Servers
Mock server
https://docs2.timify.com/_mock/apis/openapi
Production
https://api.timify.com
Staging
https://api-stg.timify.com
Local development
http://localhost:3030

Auth

Endpoints from auth routes module.

Operations

Appointments

Endpoints from appointments routes module.

Operations

Availability

Endpoints from availability routes module.

Operations

Booker Services

Endpoints from booker-services routes module.

Operations

Timeshifts

Endpoints from timeshifts routes module.

Operations

Fetch timeshift

Request

Retrieve a single timeshift entry by its ID.

Security
BearerAuth
Path
timeshiftIdstring^[0-9a-f]{24}$required

MongoDB ObjectId of the timeshift to operate on.

Example: 65f4c840b6f1a10012ab34cd
Headers
company-idstring

Company MongoDB id used in auth context.

Example: 65f4c840b6f1a10012ab34cd
curl -i -X GET \
  https://docs2.timify.com/_mock/apis/openapi/v1/timeshifts/65f4c840b6f1a10012ab34cd \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'company-id: 65f4c840b6f1a10012ab34cd'

Responses

Returns the specified time shift with complete details including resource, date, and timing information.

Bodyapplication/json
idstring

TIMIFY internal MongoDB ID.

Example: "65f4c840b6f1a10012ab34cd"
resourceIdstring

ID of the resource this timeshift belongs to.

Example: "62ee11a91d66269c365407b1"
daysArray of strings(date)

Dates covered by this timeshift.

Example: ["2026-03-10","2026-03-11"]
intervalobject(TimeInterval)

A time range with begin and end times.

workingTimesArray of objects(TimeInterval)

Working time intervals for these dates.

bookingTimesArray of objects(TimeInterval)

Online booking time intervals for these dates.

denialTimesArray of objects(TimeInterval)

Time intervals that are blocked/denied.

denialReasonstring

Reason for blocking (VACATION, SICK, BLOCKER, OTHER).

Enum"VACATION""SICK""BLOCKER""OTHER"
Example: "VACATION"
createdAtstring(date-time)

ISO 8601 date-time when the timeshift was created.

Example: "2026-01-10T08:00:00.000Z"
updatedAtstring(date-time)

ISO 8601 date-time when the timeshift was last updated.

Example: "2026-01-10T08:00:00.000Z"
Response
application/json
{
  "id": "65f4c840b6f1a10012ab34cd",
  "resourceId": "62ee11a91d66269c365407b1",
  "days": [
    "2026-03-10",
    "2026-03-11"
  ],
  "interval": {
    "begin": "00:00",
    "end": "23:59"
  },
  "workingTimes": [
    { … }
  ],
  "bookingTimes": [
    { … }
  ],
  "denialTimes": [],
  "denialReason": "VACATION"
}

Updates timeshift

Request

You can find more examples in the POST /timeshift Endpoint

Security
BearerAuth
Path
timeshiftIdstring^[0-9a-f]{24}$required

MongoDB ObjectId of the timeshift to operate on.

Example: 65f4c840b6f1a10012ab34cd
Headers
company-idstring

Company MongoDB id used in auth context.

Example: 65f4c840b6f1a10012ab34cd
Bodyapplication/json
resource_idstring

Resource id.

Example: "65f4c840b6f1a10012ab34cd"
external_resource_idstring

External resource id.

Example: "65f4c840b6f1a10012ab34cd"
fromstring(date)

Start date of the timeshift (YYYY-MM-DD).

Example: "2026-03-10"
tostring(date)

End date of the timeshift (YYYY-MM-DD, inclusive).

Example: "2026-03-11"
denial_timesArray of objects(TimeInterval)

Denial times.

working_timesArray of objects(TimeInterval)

Working times.

booking_timesArray of objects(TimeInterval)

Booking times.

denial_reasonstring

Reason for blocking the time (VACATION, SICK, BLOCKER, OTHER).

Enum"VACATION""SICK""BLOCKER""OTHER"
Example: "VACATION"
curl -i -X PATCH \
  https://docs2.timify.com/_mock/apis/openapi/v1/timeshifts/65f4c840b6f1a10012ab34cd \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'company-id: 65f4c840b6f1a10012ab34cd' \
  -d '{
    "resource_id": "65f4c840b6f1a10012ab34cd",
    "external_resource_id": "65f4c840b6f1a10012ab34cd",
    "from": "2026-03-10",
    "to": "2026-03-11",
    "denial_times": [
      {
        "begin": "08:00",
        "end": "17:00"
      }
    ],
    "working_times": [
      {
        "begin": "08:00",
        "end": "17:00"
      }
    ],
    "booking_times": [
      {
        "begin": "08:00",
        "end": "17:00"
      }
    ],
    "denial_reason": "VACATION"
  }'

Responses

Updates the time shift and returns the updated shift record.

Bodyapplication/json
dataobject(GenericRecord)

Generic response data object for proxied GraphQL entities.

Example: {"id":"65f4c840b6f1a10012ab34cd","externalId":"ext_1001","name":"Demo value"}
statusinteger

Operation status flag.

Example: 1
Response
application/json
{
  "data": {
    "id": "65f4c840b6f1a10012ab34cd",
    "resourceId": "62ee11a91d66269c365407b1",
    "resourceName": "John Smith",
    "days": [ … ],
    "workingTimes": [ … ],
    "bookingTimes": [ … ],
    "updatedAt": "2024-03-07T11:30:00Z",
    "ts": 1709823000
  },
  "status": 1
}

Customers

Endpoints from customers routes module.

Operations

Enterprise Customers

Endpoints for enterprise-level customer management.

Operations

Companies

Endpoints from companies routes module.

Operations

Enterprises

Endpoints from enterprises routes module.

Operations

Permissions

Endpoints from permissions routes module.

Operations

Services

Endpoints from services routes module.

Operations

Enterprise Services

Endpoints for enterprise-level service management.

Operations

Group Services

Endpoints from group-services routes module.

Operations

Enterprise Group Services

Endpoints from group-services-enterprise routes module.

Operations

Resources

Endpoints from resources routes module.

Operations

Enterprise Resource Categories

Endpoints for enterprise-level resource categories.

Operations

Notifications

Endpoints from notifications routes module.

Operations

Files

Endpoints from files routes module.

Operations

ICS

Endpoints from ics routes module.

Operations

Tags

Endpoints from tags routes module.

Operations

Statistics

Endpoints from statistics routes module.

Operations

Transactions

Endpoints from transactions routes module.

Operations

Public

Endpoints from public routes module.

Operations