Availabilities commands

The availabilities command lets you list, inspect, create, and update team availabilities.

List availabilities

This command shows availabilities in your workspace. Use this when you want to review working hours and availability schedules.

neetocal availabilities list
neetocal availabilities list [email protected] --page 1 --page-size 10

Optional flags:

• --emails - Comma-separated emails to filter by

• --page - Page number

• --page-size - Items per page

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

SID      NAME                                          DEF...   ID                                
──────   ───────────────────────────────────────────   ──────   ──────────────────────────────────
4tv...   New availability for Pair Programming Se...   No       7162df25-5e01-42cb-ad61-490e3bc...
6y2...   Tmp availability                              No       d95d01b1-76f8-44f0-8d84-0ddbafc...
s55...   Tmp availability                              No       cb775de8-9d1d-450c-971f-0b78e98...
qty...   Tmp availability                              No       f304781a-74aa-406e-95b0-f31a5c8...
g4u...   Tmp availability                              No       f4b00310-226d-439d-bb54-82d6fd9...
4hu...   Working hours                                 Yes      5af4c530-c753-48ef-ade7-72ef0be...
4g4...   Working hours                                 Yes      24bed48f-fedd-4a94-a963-6a11b53...

Page 1 of 1 (7 total records)

Show an availability

This command shows details for one availability. Use this when you want to inspect periods and overrides after finding the availability ID from availabilities list.

neetocal availabilities show c3d4e5f6-a7b8-9012-cdef-345678901234

Required arguments:

• <id> - Availability UUID or SID (from availabilities list)

Optional flags:

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

ID         c3d4e5f6-a7b8-9012-cdef-345678901234
  SID        ghi789z
  NAME       New availability for Pair Programming Session
  DEFAULT    No
  PERIODS    (5 items)
  OVERRIDES  []

Create an availability

This command creates a new availability. Use this when you want to set up working hours for a team member from the terminal.

neetocal availabilities create --name="Working hours" [email protected] --time-zone=America/New_York

Required flags:

• --email - Email address

Optional flags:

• --json-file - Path to JSON file with periods/overrides

• --name - Availability name

• --time-zone - Time zone

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

ID         c3d4e5f6-a7b8-9012-cdef-345678901234
  SID        avl456x
  NAME       Working hours
  DEFAULT    No
  PERIODS    []
  OVERRIDES  []

Update an availability

This command updates an availability. Use this when you need to change periods or overrides for an existing availability.

neetocal availabilities update c3d4e5f6-a7b8-9012-cdef-345678901234 --json-file=availability.json

Required arguments:

• <id> - Availability UUID or SID (from availabilities list)

Optional flags:

• --json-file - Path to JSON file with update data

• --name - Availability name

• --subdomain <name> - Target a specific logged-in workspace

• --json - Return JSON envelope output

• --quiet - Return raw payload only

• --toon - Return TOON (token-optimized) output

Sample output:

ID         c3d4e5f6-a7b8-9012-cdef-345678901234
  SID        avl456x
  NAME       Working hours (updated)
  DEFAULT    No
  PERIODS    []
  OVERRIDES  []