Objects
Object types are the most common type within GraphQL, they represent an object that can be fetched from the Worksome GraphQL API.
Address
An address.
Fields
| Name | Description |
|---|---|
address (String) |
The address. |
postCode (String) |
The post code (ZIP code). |
city (String) |
The city. |
state (String) |
The state. |
country (String) |
The country. |
AuthenticationToken
Contains information about an authentication token.
Fields
| Name | Description |
|---|---|
accessToken (String!) |
The access token for authenticating. |
Bid
Represents an bid sent on a job.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the bid. |
status (BidStatus!) |
The status of the bid |
job (Job!) |
The job which the bid was made on. |
BidPaginator
A paginated list of Bid items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Bid!]!) |
A list of Bid items. |
Bill
A bill.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the bill. |
worker (Worker!) |
The worker attached to the bill. |
recruiter (Recruiter) |
The Recruiter, if any, attached to the bill. |
company (Company!) |
The Company attached to the bill. |
number (String!) |
The unique reference for the bill. |
purchaseOrderNumber (String) |
The purchase order number assigned to the bill. |
startDate (Date) |
The start date for this billing period. |
endDate (Date) |
The end date for this billing period. |
currency (Currency!) |
The currency used for this bill. |
rate (Float) |
The charged rate for this bill. |
rateType (RateType) |
The rate type required for this bill. |
rateQuantity (Float!) |
The quantity of the selected rate type for the bill. The rate type can be seen by looking at Bill.rateType and the rate can be seen by looking at Bill.rate. |
serviceAmount (Float!) |
The fee for using the Worksome Platform. This will change depending on who is viewing the api. |
expensesAmount (Float!) |
The total amount of expenses reported on the bill. |
netAmount (Float!) |
The total amount excluding taxes. |
grossAmount (Float!) |
The total amount including taxes. |
recruiterFeeAmount (Float!) |
The agreed fee on the bill between the company and recruiter. Only the Company and Recruiter can see this. |
employmentCostAmount (Float!) |
The employment cost. The fee for payrolling a Worker. Only the Company can see this. |
billedAmount (Float!) |
The total amount excluding fees and expenses. |
date (Date!) |
The date that the bill was created. |
manuallyApprovedAt (Date) |
The manual approval date. |
approvedBy (User) |
Who the bill was approved by. |
autoApprovedAt (Date) |
The auto-approval date, if applicable. |
rejectedAt (Date) |
When the bill was rejected, if applicable. |
prepaidAt (Date) |
When the bill was prepaid, if applicable. |
hire (Hire!) |
The hire attached to the bill. |
job (Job!) |
The job attached to the bill. |
message (Message) |
The message attached to the bill. |
timesheet (Timesheet) |
The timesheet attached to the bill. |
files (FilePaginator!) |
The files attached to the bill. There could potentially be a timesheet stored as a separate file. |
BillPaginator
A paginated list of Bill items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Bill!]!) |
A list of Bill items. |
BusinessEntity
A business entity.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the business entity. |
type (BusinessEntityType!) |
The company name for the business entity. |
name (String!) |
The company name for the business entity. |
companyName (String) |
The company name for the business entity. |
companyNumber (String) |
The company number for the business entity. |
taxNumber (String) |
The tax number for the business entity. |
BusinessEntityPaginator
A paginated list of BusinessEntity items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([BusinessEntity!]!) |
A list of BusinessEntity items. |
Company
A company.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the company. |
name (String!) |
The name of the company. |
market (MarketCode!) |
The market that the company is in. |
avatar (URL) |
The company avatar. |
profile (Profile) |
The profile that the company has. |
contactInviteUrl (String) |
The company full invite url. |
trustedContacts (TrustedContactPaginator!) |
The trusted contacts that the company has. |
teamMembers (UserPaginator!) |
The team members that the company has. |
Contract
A contract.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the contract. |
jobName (String!) |
The name of the contract that the job is for. |
jobDescription (String!) |
The description of the contract that the job is for. |
locationPreference (LocationPreference!) |
The location preference of the contract. |
status (ContractStatus!) |
The status of the contract. |
startDate (Date) |
The start date of the contract. |
endDate (Date) |
The end date of the contract. |
address (String) |
The address of the contract. |
currency (Currency!) |
The type of currency. |
rateType (RateType) |
The unit of time when payment is due. |
rate (Float) |
The payment amount per specified rate type. |
purchaseOrderNumber (String) |
The Purchase Order (PO) number. |
companyCvr (String) |
The company’s Central Virksomhed (Company) Registration (CVR) number. For more information, visit: https://datacvr.virk.dk |
pdfUrl (URL) |
A URL of the actual contract. This URL will link to a PDF for the contract. This URL cannot be used for saving in external systems as it might change over time or be regenerated. If a permanent URL is needed for the contract, it should be stored in the clients own system. |
paymentTermMethod (PaymentTermMethod!) |
The method of payment over the specified term. |
paymentTerm (Int!) |
The term that the payment will be made over payment over. |
termsAccepted (Boolean!) |
Whether the contract’s terms have been accepted. |
termsAcceptedAt (DateTime) |
The date that the terms were accepted. |
workerAcceptedAt (DateTime) |
The date that the terms were accepted by a worker. |
workerSignature (String) |
The submitted signature of the accepted worker. |
job (Job!) |
The Job for which the contract is for. |
worker (Worker!) |
The Worker for which the contract is for. |
company (Company!) |
The Company for which the contract is for. |
ContractPaginator
A paginated list of Contract items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Contract!]!) |
A list of Contract items. |
Conversation
A conversation between a company and a freelancer.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the conversation. |
subject (String!) |
The subject line of the conversation. |
job (Job) |
The job that the conversation is related to. |
messages ([Message!]!) |
The messages in the conversation |
latestMessage (Message) |
The latest message sent in the conversation |
url (URL!) |
The URL for the conversation. |
createdAt (Date!) |
The date the conversation was created |
closedAt (Date) |
The date the conversation was closed |
ConversationPaginator
A paginated list of Conversation items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Conversation!]!) |
A list of Conversation items. |
CreateExportResponse
A response with data from the export creation.
Fields
| Name | Description |
|---|---|
status (ExportResponseStatus!) |
The status of the export. |
message (String!) |
A message explaining the result of the export. |
File
A file.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the file. |
name (String!) |
The name of the file. |
size (Int!) |
The size of the file in bytes. |
mimeType (String!) |
The IANA MIME type of the file. |
owner (Account!) |
The account that the file belongs to. |
url (String!) |
The URL that should be used to download the file. This URL cannot be used for saving in external systems as it might change over time or be regenerated. If a permanent URL is needed for the file, it should be stored in the clients own system. |
FilePaginator
A paginated list of File items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([File!]!) |
A list of File items. |
ForceLogoutPayload
Contains information about the user who was forcefully logged out.
Fields
| Name | Description |
|---|---|
user (User!) |
The user. |
revokedTokens ([Token!]!) |
The tokens that have been revoked. |
FreetextTimesheet
A free-text timesheet.
Fields
| Name | Description |
|---|---|
text (String!) |
The free-text content for the timesheet. |
Hire
A representation of a hiring on a job between parties.
Usually a hire is between a worker and a company on a job created by a company. A hire is not a legal document, it is simply used to show that the parties have agreed to work together. The contracts which can be found on the hire is however a legal document.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the hire. |
number (String!) |
The unique reference for the hire. |
latestContract (Contract!) |
The latest contract, not necessarily the active one. The latest contract could for example be a draft, if one of the parties wanted to make changes to the currently active contract. see hire.activeContract for the current active one. |
activeContract (Contract) |
The currently active contract. This has been accepted by all parties and is the active legal document between them. |
company (Company!) |
The company which the worker will work with. |
job (Job!) |
The job that the hire is on. |
recruiter (Recruiter) |
The recruiter attributed to the hire. |
worker (Worker!) |
The worker which the company is hiring. |
conversation (Conversation!) |
The conversation which the hire is happening on. |
createdAt (Date!) |
The date the hire was created on. |
dateStart (Date) |
The date the hire started. |
dateEnd (Date) |
The date the hire ended. |
recruiterOwnershipStartDate (Date) |
The date that recruiter ownership started. |
recruiterFee (Percentage) |
The recruiter’s fee. |
recruiterOwnershipDays (Int) |
The number of ownership days for the recruiter. |
recruiterOwnershipIsExpired (Boolean) |
Indicates whether or not the recruiter ownership has expired yet. |
recruiterOwnershipDaysLeft (Int) |
Number of days left in the recruiter’s ownership. |
currency (String!) |
The currency of the hire. |
rate (Float) |
The rate for the hire. |
rateType (String) |
The rate type for the hire. |
contracts (ContractPaginator!) |
The contracts for the hire. These are legal documents, however it can contain old contracts and drafts also. |
bills (BillPaginator!) |
The bills created on the hire. |
HirePaginator
A paginated list of Hire items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Hire!]!) |
A list of Hire items. |
Industry
An industry.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the industry. |
name (String!) |
The name of the industry. |
IndustryPaginator
A paginated list of Industry items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Industry!]!) |
A list of Industry items. |
InternalField
An internal field.
Fields
| Name | Description |
|---|---|
id (ID!) |
The id of the field. |
user (User!) |
The user that the field is owned by. |
account (Account!) |
The account that the field is owned by. |
title (String!) |
The title of the field. |
fieldType (InternalFieldType!) |
The type of the field. |
appliesTo (SupportsInternalFields!) |
The type of item that the field applies to. |
fieldOptions ([InternalFieldOption!]!) |
The possible options for the field. |
fieldValues ([InternalFieldValue!]!) |
The possible values for the field. |
isUsedInFieldValues (Boolean!) |
Whether the field is used in any field values. |
InternalFieldOption
An internal field option.
Fields
| Name | Description |
|---|---|
id (ID!) |
The id of the field option. |
account (Account!) |
The account that the field option can be used by. |
user (User!) |
The user that owns the field option. |
field (InternalField!) |
The field that the field option is valid for. |
displayOrder (Int!) |
The display order of the field option. |
value (String!) |
The value of the field option. |
InternalFieldPaginator
A paginated list of InternalField items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([InternalField!]!) |
A list of InternalField items. |
InternalFieldValue
An internal field value.
Fields
| Name | Description |
|---|---|
id (ID!) |
The id of the field value. |
account (Account!) |
The account that the field value can be used by. |
user (User!) |
The user that owns the field value. |
field (InternalField!) |
The field that the field value is valid for. |
fieldOption (InternalFieldOption) |
The field option that the field value is valid for. |
value (String) |
The field option that the field value is valid for. |
Invoice
An invoice.
An invoice gets created when one or more worker bills gets approved by a company user. The invoice defines the amount due and is to be paid to Worksome by the company.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the invoice. |
number (String!) |
A number referencing the invoice. This is usually printed on the invoice itself and should be used by booking system and finance departments. The format is a human readable format |
pdfUrl (URL!) |
A URL of the actual invoice. This url will link to a pdf for the invoice. This URL cannot be used for saving in external systems as it might change over time or be regenerated. If a permanent URL is needed for the invoice, it should be stored in the clients own system. |
currency (Currency!) |
The type of currency. |
grossAmount (Float!) |
The total amount including taxes etc. |
taxAmount (Float!) |
The total amount of taxes to be paid. |
netAmount (Float!) |
The total amount without taxes |
markedPaidAt (Date) |
The date of which the invoice was marked paid by Worksome. This date might vary from the actual date it was paid, as it takes time for a payment to go through and be validated. |
dueDate (Date!) |
The date of which the invoice should be paid by. |
company (Company!) |
The Company for which the invoice is for. |
date (Date!) |
The date of which the invoice was created. |
isBatched (Boolean!) |
Checks if the invoice is a batched invoice. A batch invoice aggregates multiple bills together in one, summarised invoice over a period of time. This reduces the overhead of processing high volumes of bills and corresponding invoices. |
transactionType (InvoiceTransactionType!) |
The type of transaction to be used for the invoice. |
rows (InvoiceRowPaginator!) |
A paginated list of all the rows on the invoice. This can be used to gather more information about the invoice then just overall amount. |
InvoicePaginator
A paginated list of Invoice items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Invoice!]!) |
A list of Invoice items. |
InvoiceRow
A row on the invoice.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the invoice row. |
bill (Bill) |
The bill which the row on the invoice is related to. |
worker (Worker) |
The worker that is linked to this row. |
customText (String) |
A custom text which will be shown on the invoice pdf. |
InvoiceRowPaginator
A paginated list of InvoiceRow items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([InvoiceRow!]!) |
A list of InvoiceRow items. |
Job
A job that a company has created on Worksome.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the job. |
name (String!) |
The name of the job. |
skills ([Skill!]!) |
The skills required for the job. |
description (String) |
The description of the job. |
market (MarketCode!) |
The market that the job is in. |
address (String) |
The address of the job. |
currency (Currency!) |
The type of currency. |
rateType (RateType) |
The unit of time when payment is due. |
rate (Float) |
The payment amount per specified rate type. |
minimumRate (Float) |
The minimum payment amount per specified rate type. |
maximumRate (Float) |
The maximum payment amount per specified rate type. |
paymentScheme (PaymentScheme) |
The payment scheme that the job will use. |
companyFee (StrictPercentage) |
The company fee (as a percentage). |
workerFee (StrictPercentage) |
The worker fee (as a percentage). |
association (ProjectType) |
The project type of the job. |
internalBudget (Float) |
Internal budget of the project. |
spent (Float!) |
Total job spent. Only a company owning the job could access the budget. |
expectedExperienceLevel ([ExpectedExperienceLevel!]!) |
The expected experience levels required for the job. |
locationPreference (LocationPreference) |
The location preference of the job. |
startDate (Date) |
The start date of the job. |
endDate (Date) |
The end date of the job. |
attachments ([File!]!) |
The project type of the job. |
evaluationPeriod (EvaluationPeriod!) |
The period of time required to reply to candidates. |
languages ([Language!]!) |
The languages required for the job. |
industries ([Industry!]!) |
The industries that the worker requires experience in for the job. |
requiredWorkers (Int) |
The number of required workers. If excluded, the default is 1 profile. |
owners ([User!]!) |
The owners of the job posting. |
internalFields ([InternalFieldValue!]!) |
Additional internal fields for the job. Details specified in this will only be visible to you and your team members, not to workers. |
visibility ([JobVisibility!]!) |
The audiences that will be able to see the job listing. |
approved (Boolean!) |
Has the job been approved by Worksome. |
paused (Boolean!) |
Is the job currently paused. |
completed (Boolean!) |
Is the completed. |
publishedAt (DateTime) |
The date which the job was published at. |
company (Company!) |
The Company for which the job is for. |
region (String) |
The region for the job. |
url (URL!) |
The URL for the job. |
hires (HirePaginator!) |
The hires made on the job. |
conversations (ConversationPaginator!) |
The conversations involving the job. |
notes (NotePaginator!) |
Notes added to the job. These can only be seen by the job owner. |
bills (BillPaginator!) |
The bills created on the job. |
bids (BidPaginator!) |
The bids submitted for the job. |
JobPaginator
A paginated list of Job items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Job!]!) |
A list of Job items. |
Language
A language that is required for a job.
Fields
| Name | Description |
|---|---|
name (LanguageName!) |
The name of the language. |
experience (Fluency!) |
The required level of the language. |
Link
A link on a profile
Fields
| Name | Description |
|---|---|
title (String!) |
The title of the link |
url (URL!) |
The url of the link |
Market
A market.
Fields
| Name | Description |
|---|---|
code (MarketCode!) |
The market code. |
name (String!) |
The name of the market. |
Message
A message as part of a conversation
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the message. |
body (String) |
The body of the message. |
author (User) |
The author of the message. |
url (URL!) |
The URL for the profile. |
MultiFactorPaginator
A paginated list of MultiFactor items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([MultiFactor!]!) |
A list of MultiFactor items. |
Note
A note for a job on Worksome.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the note. |
title (String!) |
The title of the note. |
body (String!) |
The body of the note. |
author (User!) |
The author of the note. |
NotePaginator
A paginated list of Note items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Note!]!) |
A list of Note items. |
Organisation
An organisation.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the organisation. |
name (String!) |
The name of the organisation. |
market (MarketCode!) |
The market that the organisation is in. |
PageInfo
Information about pagination using a Relay style cursor connection.
Fields
| Name | Description |
|---|---|
hasNextPage (Boolean!) |
When paginating forwards, are there more items? |
hasPreviousPage (Boolean!) |
When paginating backwards, are there more items? |
startCursor (String) |
The cursor to continue paginating backwards. |
endCursor (String) |
The cursor to continue paginating forwards. |
total (Int!) |
Total number of nodes in the paginated connection. |
count (Int!) |
Number of nodes in the current page. |
currentPage (Int!) |
Index of the current page. |
lastPage (Int!) |
Index of the last available page. |
PaginatorInfo
Information about pagination using a fully featured paginator.
Fields
| Name | Description |
|---|---|
count (Int!) |
Number of items in the current page. |
currentPage (Int!) |
Index of the current page. |
firstItem (Int) |
Index of the first item in the current page. |
hasMorePages (Boolean!) |
Are there more pages after this one? |
lastItem (Int) |
Index of the last item in the current page. |
lastPage (Int!) |
Index of the last available page. |
perPage (Int!) |
Number of items per page. |
total (Int!) |
Number of total available items. |
Profile
A profile.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the profile. |
url (URL!) |
The URL for the profile. |
links ([Link!]!) |
The links for the profile |
Project
A project with a budget containing one or more jobs.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the project. |
name (String!) |
The name of the project. |
description (String) |
The description of the project. |
currency (Currency!) |
The currency used for this project. |
creator (User!) |
The creator of the project. |
company (Company!) |
The company that the project is for. |
internalBudget (Decimal) |
The total internal budget for the project. |
allocatedBudget (Decimal!) |
The sum of all associated job budgets that have been allocated to the internal budget of the project. |
spent (Decimal!) |
The amount that is spent out of the internal budget for the project. Spent for the project budget is registered when a bill is approved on an associated job. |
endDate (Date) |
The end date for this project. If this is set to null, we will assume that the project is not yet ended but active. |
owners ([User!]!) |
The owners of the project. |
jobs (JobPaginator!) |
Jobs added to this project. |
ProjectPaginator
A paginated list of Project items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Project!]!) |
A list of Project items. |
Recruiter
A recruiter.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the recruiter. |
name (String!) |
The name of the recruiter. |
market (MarketCode!) |
The market that the company is in. |
initials (String!) |
The initials of the recruiter |
avatar (URL) |
The recruiter avatar |
RecruiterPaginator
A paginated list of Recruiter items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Recruiter!]!) |
A list of Recruiter items. |
SimplePaginatorInfo
Information about pagination using a simple paginator.
Fields
| Name | Description |
|---|---|
count (Int!) |
Number of items in the current page. |
currentPage (Int!) |
Index of the current page. |
firstItem (Int) |
Index of the first item in the current page. |
lastItem (Int) |
Index of the last item in the current page. |
perPage (Int!) |
Number of items per page. |
hasMorePages (Boolean!) |
Are there more pages after this one? |
Skill
A skill that is required for a job.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID for the skill. |
name (String!) |
The name of the skill. |
SkillPaginator
A paginated list of Skill items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Skill!]!) |
A list of Skill items. |
SmsCreateMultiFactorPayload
A response payload for a newly-created SMS multi-factor authentication implementation.
Fields
| Name | Description |
|---|---|
multiFactor (SmsMultiFactor!) |
The newly-created SMS multi factor. |
SmsMultiFactor
An SMS multi-factor authentication implementation.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the SMS multi-factor authentication implementation. |
name (String!) |
The name of the SMS multi-factor authentication implementation. |
phoneNumber (E164PhoneNumber!) |
The phone number for the SMS multi-factor authentication implementation. |
status (Status!) |
The status of the SMS multi-factor authentication implementation. |
owner (User!) |
The owner of the SMS multi-factor authentication implementation. |
verifiedAt (DateTime) |
When the SMS multi-factor authentication implementation was verified. |
createdAt (DateTime!) |
When the SMS multi-factor authentication implementation was created. |
updatedAt (DateTime!) |
When the SMS multi-factor authentication implementation was updated. |
SpreadsheetTimesheet
A spreadsheet-based timesheet.
Fields
| Name | Description |
|---|---|
rows ([SpreadsheetTimesheetRow!]!) |
The rows for the spreadsheet. |
SpreadsheetTimesheetRow
A spreadsheet-based timesheet row.
Fields
| Name | Description |
|---|---|
date (Date!) |
The date specified for the timesheet row. |
quantity (Float!) |
The quantity of the selected rate type for the bill. The rate type can be seen by looking at Bill.rateType and the rate can be seen by looking at Bill.rate. |
description (String!) |
The description of the timesheet row. |
Tag
A tag.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the tag. |
name (String) |
The name of the tag. |
TagPaginator
A paginated list of Tag items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([Tag!]!) |
A list of Tag items. |
Token
Contains information about an authentication token.
Fields
| Name | Description |
|---|---|
jti (String!) |
The access token JTI (JWT ID). |
TotpCreateMultiFactorPayload
A response payload for a newly-created TOTP multi-factor authentication implementation.
Fields
| Name | Description |
|---|---|
multiFactor (TotpMultiFactor!) |
The newly-created TOTP multi factor. |
secret (String!) |
The secret for the newly-created TOTP multi factor. |
qrCode (URL!) |
A URL for the QR Code containing the secret. This is not the QR Code itself, but the URL that the QR code should contain. The URL is in otpauth format. |
TotpMultiFactor
A TOTP multi-factor authentication implementation.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the TOTP multi-factor authentication implementation. |
name (String!) |
The name of the TOTP multi-factor authentication implementation. |
status (Status!) |
The status of the TOTP multi-factor authentication implementation. |
owner (User!) |
The owner of the TOTP multi-factor authentication implementation. |
verifiedAt (DateTime) |
When the TOTP multi-factor authentication implementation was verified. |
createdAt (DateTime!) |
When the TOTP multi-factor authentication implementation was created. |
updatedAt (DateTime!) |
When the TOTP multi-factor authentication implementation was updated. |
TrustedContact
A trusted contact.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the trusted contact. |
worker (Worker!) |
The trusted contact worker. |
company (Company!) |
The trusted contact company. |
invitedByUser (User) |
The user who invited the worker as trusted contact of the company A “null” value here means th trusted contact was automatically added by a process |
viewerCanContact (Boolean!) |
Whether the viewer is able to contact the trusted contact. |
links ([String!]!) |
Links associated with the trusted contact |
attachments ([File!]!) |
File attachments uploaded by the company that are related to the worker |
skills ([Skill!]!) |
Skills associated with the trusted contact |
status (ContactStatusEnum!) |
Status of the trusted contact. |
statusUpdatedAt (Date!) |
Date that the status of the trusted contact was last updated at. |
tags (TagPaginator!) |
The tags for a trusted contact. |
TrustedContactPaginator
A paginated list of TrustedContact items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([TrustedContact!]!) |
A list of TrustedContact items. |
User
Account of a person who utilizes this application.
Fields
| Name | Description |
|---|---|
id (ID!) |
Unique primary key. |
name (String!) |
Non-unique name. |
email (String!) |
Unique email address. |
emailVerifiedAt (DateTime) |
When the email was verified. |
createdAt (DateTime!) |
When the account was created. |
updatedAt (DateTime!) |
When the account was last updated. |
canCreatePassword (Boolean!) |
Whether the user is allowed to create a password for their account. The user might not be allowed if they already have a password, in which case they should use updatePassword or if they have SAML on their account. |
missingAuthentication (Boolean!) |
Whether the user has any way of authenticating into the system. This will check that the user has no password, social, SAML etc. way of authenticating into their account. |
hasVerifiedEmail (Boolean!) |
Checks whether the user has verified their email or not. |
UserPaginator
A paginated list of User items.
Fields
| Name | Description |
|---|---|
paginatorInfo (PaginatorInfo!) |
Pagination information about the list of items. |
data ([User!]!) |
A list of User items. |
Vendor
A vendor.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the vendor. |
name (String!) |
The name of the vendor. |
market (MarketCode!) |
The market that the vendor is in. |
Worker
A worker.
Fields
| Name | Description |
|---|---|
id (ID!) |
The ID of the worker. |
name (String!) |
The name of the worker. |
email (String) |
The email of the worker. |
phone (String) |
The phone of the worker. |
avatar (URL) |
The worker avatar |
address (Address) |
The address that the worker is registered to. |
market (Market!) |
The market that the worker is in. |
profile (Profile) |
The profile that the worker has. |
viewerIsClient (Boolean) |
Whether the worker is a trusted contact for the current viewer. Only companies can see this. |
jobTitle (String) |
The job title that the worker has. |
initials (String!) |
The initials for the workers’ name |
currency (String!) |
The currency that the worker uses |
dayRate (Float) |
The daily rate for the worker |
primaryBusinessEntity (BusinessEntity) |
the business entity that the worker uses |
businessEntities (BusinessEntityPaginator!) |
The business entities that the worker has. |
skills (SkillPaginator!) |
The skills that the worker has. |
hires (HirePaginator!) |
The hires associated with the worker |