Companies Resources

GetCompanies

Description Returns list of company IDs and their names for companies that were created on behalf of the current partner
Entry Point https://www.talentfilter.biz/ws/companies.asmx
Method Signature GetCompanies(string authToken): string
Parameters authToken: Authentication token that identifies partner application
Result xml string

Samples

Sample Request

            
         XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
         

 Sample Response



00000000-0000-0000-0000-000000000000
name1


any string max 50 chars
name2

GetCompany

Description Returns company details according to company schema
Entry Point https://www.talentfilter.biz/ws/companies.asmx
Method Signature GetCompany(string authToken, string companyId): string
Parameters

authToken: authentication token that identifies partner application

companyId: unique ID of a company to be retrieved (max 50 chars)

Result xml string

Samples

Sample Request

 

            
         XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
         00000000-0000-0000-0000-000000000000
         

 

Sample Response

 


   00000000-0000-0000-0000-000000000000
   some title
   … see [API Schema] for full list of fields here …

AddCompany

Description Adds a new company on behalf of the current partner authorized by auth token.
Entry Point https://www.talentfilter.biz/ws/companies.asmx
Method Signature AddCompany(string authToken, string companyDescriptionXml): string
Parameters

authToken: Authentication token that identifies partner application

companyDescriptionXml: Company details according to company schema

Result Full description XML of the company as it was just created in the database

Samples

Request Sample

 

            
         XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
         
            
                Enabled
                My Company
            
                  

 

Result Sample

 


   [unique string]
   My Company
   … see [API Schema] for full list of fields here …

UpdateCompany

Description Updates the existing company on behalf of the current partner authorized by auth token; id of the company should exist in the database; all other specified fields will be overwritten
Entry Point https://www.talentfilter.biz/ws/companies.asmx
Method Signature UpdateCompany(string authToken, string companyDescriptionXml): string
Parameters

authToken: Authentication token that identifies partner application

companyDescriptionXml: Company details according to company schema; is obligatory; the rest of the fields are optional, but at least one (except ) should be specified

Result Full description XML of the company as it was updated in the database.

Samples

Request Sample

 

            
         XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
         
            
                [company id]
                Enabled
                My Company
            
                  

 

Result Sample

 


   [company id]
   My Company
   … see [API Schema] for full list of fields here …

DeleteCompany

Description Removes company from the database
Entry Point https://www.talentfilter.biz/ws/companies.asmx
Method Signature DeleteCompany(string authToken, string companyId): string
Parameters

authToken: Authentication token that identifies partner application

seatId: Unique ID of a company to be deleted (max 50 chars)

Result Company ID that was just deleted (xml string)

Samples

Request Sample

 

            
         XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
         
            
                [company id]
                Enabled
                My Company
            
                  

 

Result Sample

 

00000000-0000-0000-0000-000000000000